git diff

Pasemos ahora a examinar un desglose más detallado del resultado de la diferencia.

En esta línea se muestran las fuentes de entrada de la comparación. Podemos observar que se ha utilizado a/diff_test.txt y b/diff_test.txt en la comparación.

En esta línea se muestran unos cuantos metadatos internos de Git. Lo más probable es que no necesites esta información. Los números de este resultado se corresponden con los identificadores hash de la versión del objeto de Git.

Estas líneas conforman una leyenda que asigna símbolos a cada origen de entrada de la comparación. En este caso, los cambios de a/diff_test.txt se marcan con un --- y, los de b/diff_test.txt, con el símbolo +++.

El producto restante de la diferencia es una lista de "fragmentos" de la diferencia. Una diferencia solo muestra las secciones del archivo con cambios. En el ejemplo en cuestión, solo hay un fragmento porque estamos trabajando con un caso sencillo. Los fragmentos poseen su propia semántica pormenorizada del resultado.

La primera línea es el encabezado del fragmento. Cada fragmento comienza con un encabezado delimitado por símbolos @@. El contenido de dicho encabezado es un resumen de los cambios efectuados en el archivo. En nuestro ejemplo simplificado pone "-1 +1", lo que significa que ha habido cambios en la primera línea. En una diferencia más realista, se podría ver un encabezado como el siguiente:

En este ejemplo de encabezado, lo que pone es que se han extraído 6 líneas a contar desde la línea número 34. Además, se han añadido 8 líneas a partir de la línea número 34.

El resto del contenido del fragmento muestra los cambios recientes. Todas las líneas cambiadas comienzan por un símbolo + o -, que sirve para indicar de qué versión de la entrada de la comparación proceden los cambios. Como ya hemos comentado antes, - indica cambios en a/diff_test.txt, mientras que "+" indica cambios en b/diff_test.txt.

Ahora, el resultado muestra solo las palabras coloreadas que han cambiado.

Si clonas el código fuente de git, verás un subdirectorio llamado "contrib", que contiene una serie de herramientas relacionadas con Git, así como otras interesantes cositas que todavía no se han promovido al núcleo de Git. Una de ellas es un script en Perl llamado "diff-highlight". Diff-highlight empareja líneas coincidentes del resultado de la diferenciación y resalta los fragmentos menores que una palabra que han cambiado.

De este modo, se reduce la diferencia al mínimo cambio posible.

Git tiene una función que te permite especificar un comando de shell para transformar el contenido de tus archivos binarios en texto antes de ejecutar el comando diff, pero para ello hay que hacer unos pequeños ajustes. En primer lugar, tienes que especificar un filtro de textconv que exponga cómo convertir en texto un tipo concreto de archivo binario. Usaremos una sencilla utilidad llamada "pdftohtml" (disponible a través de Homebrew) para convertir unos PDF en HTML legible para humanos. Puedes configurar esto para un solo repositorio editando el archivo .git/config o bien globalmente editando ~ /.gitconfig.

Acto seguido, lo único que tienes que hacer es asociar al menos un patrón de archivos a nuestro filtro pdfconv, para lo cual puedes crear un archivo .gitattributes en la raíz del repositorio.

Una vez configurado, git diff ejecutará primero el archivo binario mediante el script de conversor configurado y producirá la comparación del resultado del conversor. Esta misma técnica se puede aplicar para obtener diferencias útiles de todo tipo de archivos binarios como, por ejemplo, archivos .zip o .jar. Por ejemplo: si utilizas unzip -l (o semejante) en vez de "pdf2html", te mostrará las rutas que se han añadido o eliminado entre imágenes de confirmaciones. Por otro lado, se puede utilizar "exiv2" para mostrar cambios en los metadatos como, por ejemplo, documentos de dimensiones de imágenes. Asimismo, existen herramientas de conversión para transformar archivos .odf, .doc y otros formatos de documento a texto sin formato. Si no hay otra opción, las cadenas normalmente funcionarán con archivos binarios para los que no existe ningún conversor formal.

En este ejemplo, el alcance se restringe a ./path/to/file y, al invocar el comando, este comparará los cambios concretos efectuados en el directorio de trabajo con respecto al índice, y mostrará los cambios que todavía no se han preparado. De forma predeterminada, git diff ejecutará la comparación con respecto a HEAD. Si se omite HEAD en el ejemplo anterior, git diff ./path/to/file surtirá el mismo efecto.

Al invocar git diff con la opción --cached, el comando comparará los cambios preparados con el repositorio local. La opción --cached equivale a --staged.

Al invocar git diff sin ninguna ruta de archivo, se compararán los cambios efectuados en todo el repositorio. Los ejemplos anteriores con archivos concretos se pueden invocar sin el argumento ./path/to/file y generar los mismos resultados en todos los archivos del repositorio local.

De forma predeterminada, git diff te mostrará todos los cambios sin confirmar desde la última confirmación.

En el comando git diff se pueden utilizar referencias de Git a confirmaciones para mostrar las diferencias. Por ejemplo, algunas de estas referencias son HEAD, etiquetas y nombres de ramas. En Git, todas las confirmaciones tienen su correspondiente ID y, para obtenerlo, puedes ejecutar GIT LOG. También puedes utilizar este ID de confirmación en git diff.

Este ejemplo introduce el punto como operador. Los dos puntos de este ejemplo indican que la entrada de diferencia son los extremos de ambas ramas. Si se omiten estos puntos y se utiliza un espacio entre las ramas, el efecto que se produce es el mismo. Además, está el operador de tres puntos:

El operador de tres puntos inicia la comparación cambiando el primer parámetro de entrada, branch1, ya que convierte branch1 en una referencia de la confirmación antecesora común compartida entre las dos entradas de diferencia, el antecesor compartido de branch1 y other-feature-branch. El último parámetro de entrada permanece inmutable como extremo de other-feature-branch.