git diff

Examinons à présent plus en détail les composants de la sortie du diff.

Cette ligne affiche les sources d'entrée du diff. Nous pouvons voir que les fichiers a/diff_test.txt et b/diff_test.txt ont été transmis au diff.

Cette ligne affiche quelques métadonnées Git internes. Vous n'aurez probablement pas besoin de ces informations. Les chiffres de cette sortie correspondent aux identifiants de hachage de la version de l'objet Git.

Ces lignes sont une légende qui assigne des symboles à chaque source d'entrée de diff. Le cas échéant, les changements apportés au fichier a/diff_test.txt sont marqués par un --- et les changements apportés au fichier b/diff_test.txt sont marqués par le symbole +++.

La sortie de diff restante est une liste de « segments » de diff. Un diff n'affiche que les sections du fichier qui ont été modifiées. Dans notre exemple actuel, nous n'avons qu'un seul segment, car nous travaillons avec un scénario simple. Les segments ont leur propre sémantique de sortie granulaire.

La première ligne est l'en-tête du segment. Chaque segment est précédé d'un en-tête inclus entre des symboles @@. Le contenu de l'en-tête est un résumé des changements apportés au fichier. Dans notre exemple simplifié, nous avons -1 +1, ce qui signifie que la première ligne a été modifiée. Dans un diff plus réaliste, vous verriez un en-tête comme :

Dans cet exemple d'en-tête, six lignes ont été extraites à partir de la ligne 34. En outre, huit lignes ont été ajoutées à partir de la ligne 34.

Le reste du contenu du segment de diff affiche les changements récents. Chaque ligne modifiée est précédée d'un symbole + ou - indiquant la version d'entrée de diff d'où viennent les changements. Comme nous l'avons vu précédemment, - indique des changements dans le fichier a/diff_test.txt et + indique des changements dans le fichier b/diff_test.txt.

Maintenant, la sortie n'affiche que les mots qui ont changé avec un code de couleurs.

Si vous clonez la source Git, vous trouverez un sous-répertoire appelé contrib. Il contient une série d'outils liés à Git et d'autres éléments intéressants qui n'ont pas encore été intégrés aux commandes de base de Git. L'un d'entre eux est un script Perl appelé diff-highlight. diff-highlight apparie les lignes correspondantes de la sortie de diff et met en évidence les fragments de sous-mots qui ont changé.

Nous avons maintenant réduit notre diff au plus petit changement possible.

Git dispose d'une fonction qui vous permet de spécifier une commande shell pour transformer le contenu de vos fichiers binaires en texte avant d'effectuer le diff. Cela nécessite cependant un peu de configuration. Tout d'abord, vous devez spécifier un filtre textconv décrivant comment convertir un certain type de fichier binaire en fichier texte. Nous utilisons un simple utilitaire appelé pdftohtml (disponible via Homebrew) pour convertir les fichiers PDF en fichiers HTML lisibles par l'homme. Vous pouvez le configurer pour un seul dépôt en modifiant votre fichier .git/config ou globalement en modifiant ~ /.gitconfig.

Il vous suffit alors d'associer un ou plusieurs modèles de fichiers à notre filtre pdfconv. Pour cela, créez un fichier .gitattributes à la racine de votre dépôt.

Une fois configuré, git diff exécutera d'abord le fichier binaire via le script de conversion configuré et effectuera un diff sur la sortie du convertisseur. La même technique peut être appliquée pour obtenir des diffs exploitables à partir de toutes sortes de fichiers binaires, par exemple : pour les fichiers ZIP, JAR et autres archives, utiliser unzip -l (ou une commande similaire) au lieu de pdf2html vous montrera les chemins qui ont été ajoutés ou supprimés entre les images de commit. La commande exiv2 peut être utilisée pour afficher les changements apportés aux métadonnées comme les documents de dimensions d'image : des outils de conversion existent pour transformer les formats de fichiers .odf, .doc et autres en texte brut. En cas de problème, les chaînes de caractères fonctionnent souvent pour les fichiers binaires pour lesquels il n'existe pas de convertisseur formel.

Cet exemple est limité à ./path/to/file. Lorsqu'il est appelé, il comparera les changements spécifiques dans le répertoire de travail, par rapport à l'index, en indiquant les changements qui ne sont pas encore stagés. Par défaut, git diff effectue la comparaison par rapport à HEAD. Omettre HEAD dans l'exemple ci-dessus, git diff ./path/to/file, a le même résultat.

Lorsque la commande git diff est appelée avec l'option --cached, le diff compare les changements stagés avec le dépôt local. L'option --cached est synonyme de --staged.

Appeler git diff sans chemin d'accès au fichier comparera les changements dans l'ensemble du dépôt. Les exemples ci-dessus, propres à des fichiers, peuvent être appelés sans l'argument ./path/to/file et génèrent la même sortie pour tous les fichiers du dépôt local.

Par défaut, git diff vous montre tous les changements non commités depuis le dernier commit.

Des réfs Git à des commits sur lesquels effectuer un diff peuvent être transmises à git diff. Exemples de réfs : HEAD, tags et noms de branche. Chaque commit dans Git possède un ID de commit que vous pouvez obtenir en exécutant GIT LOG. Vous pouvez également transmettre cet ID de commit à git diff.

Cet exemple présente l'opérateur de point. Les deux points de cet exemple indiquent que la différence entre les deux entrées est l'extrémité des deux branches. Le même effet se produit si les points sont omis et qu'un espace est utilisé entre les branches. En outre, il existe un opérateur à trois points :

L'opérateur à trois points initie le diff en modifiant le premier paramètre d'entrée, branch1. Il change branch1 en une réf de commit d'ancêtre commun entre les deux entrées du diff, l'ancêtre commun de branch1 et other-feature-branch. Le dernier paramètre d'entrée reste inchangé en tant que pointe de other-feature-branch.