git diff

Esaminiamo ora una suddivisione più dettagliata dell'output delle differenze.

Questa riga mostra le sorgenti di input del diff. Possiamo vedere che a/diff_test.txt e b/diff_test.txt sono stati passati al diff.

Questa riga mostra alcuni metadati Git interni. Molto probabilmente non avrai bisogno di queste informazioni. I numeri in questo output corrispondono agli identificatori hash della versione dell'oggetto Git.

Queste righe sono una legenda che assegna simboli a ciascuna sorgente di input differenziale. In questo caso, le modifiche da a/diff_test.txt sono contrassegnate da — e le modifiche da b/diff_test.txt sono contrassegnate dal simbolo +++.

Il risultato differenziale rimanente è un elenco di «blocchi» di diff. Un diff mostra solo le sezioni del file che sono state modificate. Nel nostro esempio attuale, abbiamo solo un blocco, poiché stiamo lavorando con uno scenario semplice. I blocchi hanno una propria semantica granulare di output.

La prima riga è l'intestazione del blocco. Ogni blocco è preceduto da un'intestazione racchiusa tra i simboli @@. Il contenuto dell'intestazione è un riepilogo delle modifiche apportate al file. Nel nostro esempio semplificato, abbiamo -1 +1, che significa che la prima riga presenta delle modifiche. In una differenza più realistica, vedrai un'intestazione del tipo:

In questo esempio di intestazione, sono state estratte 6 righe a partire dalla riga numero 34. Inoltre, sono state aggiunte 8 righe a partire dalla riga numero 34.

Il contenuto rimanente del blocco diff mostra le modifiche recenti. Ogni riga modificata è preceduta da un simbolo + o - che indica da quale versione dell'input diff provengono le modifiche. Come abbiamo detto in precedenza, - indica le modifiche dal file a/diff_test.txt e + indica le modifiche da b/diff_test.txt.

Ora l'output mostra solo le parole con codice colore che sono cambiate.

Se cloni la sorgente git, troverai una sottodirectory chiamata contrib. Contiene numerosi strumenti relativi a git e altri elementi interessanti che non sono ancora stati promossi a git core. Uno di questi è uno script Perl chiamato diff-highlight. Diff-highlight accoppia le righe corrispondenti di output diff ed evidenzia i frammenti di sottoparole che sono cambiati.

Ora abbiamo ridotto la nostra differenza alla minima modifica possibile.

Git ha una funzione che ti consente di specificare un comando shell per trasformare il contenuto dei tuoi file binari in testo prima di eseguire il diff. Però richiede un po' di configurazione. Innanzitutto, devi specificare un filtro textconv che descriva come convertire un determinato tipo di file binario in testo. Stiamo usando una semplice utilità chiamata pdftohtml (disponibile tramite homebrew) per convertire i miei PDF in codice HTML leggibile dall'uomo. Puoi configurarlo per un singolo repository modificando il tuo file .git/config, oppure a livello globale, modificando ~ /.gitconfig

Quindi tutto ciò che devi fare è associare uno o più modelli di file al nostro filtro pdfconv. Puoi farlo creando un file .gitattributes nella directory principale del repository.

Una volta configurato, git diff eseguirà prima il file binario tramite lo script del convertitore configurato ed eseguirà la differenza dell'output del convertitore. La stessa tecnica può essere applicata per ottenere differenze utili da tutti i tipi di file binari, ad esempio: zip, jar e altri archivi: l'uso di unzip -l (o simile) al posto di pdf2html ti mostrerà i percorsi che sono stati aggiunti o rimossi tra immagini di commit: exiv2 può essere usato per mostrare le modifiche ai metadati come i documenti delle dimensioni delle immagini: esistono strumenti di conversione per trasformare .odf, .doc e altri formati di documenti in testo normale. Se necessario, le stringhe spesso funzionano per i file binari in cui non esiste un convertitore formale.

Questo esempio è incluso nell'ambito di . /path/to/file quando richiamato, confronterà le modifiche specifiche nella directory di lavoro con l'indice, mostrando le modifiche che non sono ancora state eseguite. Per impostazione predefinita, git diff eseguirà il confronto con HEAD. Omettendo HEAD nell'esempio precedente git diff. /path/to/file ha lo stesso effetto.

Quando git diff viene invocato con l'opzione —cached, diff confronterà le modifiche temporizzate con il repository locale. L'opzione —cached è sinonimo di —staged.

Il richiamo di git diff senza un percorso del file confronterà le modifiche nell'intero repository. Gli esempi specifici dei file riportati qui sopra possono essere richiamati senza l'argomento ./path/to/file e hanno gli stessi risultati di output su tutti i file nel repository locale.

Per impostazione predefinita, git diff ti mostrerà tutte le modifiche non salvate dall'ultimo commit.

Con git diff si possono passare i riferimenti Git ai commit in diff. Alcuni riferimenti di esempio sono HEAD, tag e nomi di branch. Ogni commit in Git ha un ID di commit che puoi ottenere quando esegui GIT LOG. Puoi anche passare questo ID di commit a git diff.

Questo esempio introduce l'operatore punto. I due punti in questo esempio indicano che il diff inserito è la punta di entrambi i branch. Lo stesso effetto si verifica se i punti vengono omessi e viene utilizzato uno spazio tra i branch. Inoltre, c'è un operatore a tre punti:

L'operatore a tre punti avvia diff modificando il primo parametro di input branch1. Cambia branch1 in un riferimento del commit predecessore comune condiviso tra i due input diff, il predecessore condiviso di branch1 e un altro branch di funzionalità. L'ultimo parametro di input del parametro rimane invariato come la punta di un altro branch di funzionalità.