git diff

Przyjrzyjmy się dokładniej strukturze danych wykazu różnic.

Ten wiersz zawiera źródła wejściowe wykazu różnic. Widzimy, że do polecenia zostały przekazane pliki a/diff_test.txt i b/diff_test.txt.

Ten wiersz zawiera wewnętrzne metadane Git. Najprawdopodobniej nie będziemy potrzebować tych informacji. Liczby w tym wierszu odpowiadają hashom wersji obiektów Git.

Te wiersze stanowią legendę symboli przypisanych do każdego źródła wejściowego wykazu. W tym przypadku zmiany z pliku a/diff_test.txt zostały oznaczone symbolem ---, natomiast zmiany z pliku b/diff_test.txt symbolem +++.

Pozostałą treść stanowi lista elementów wykazu różnic. Obejmuje on wyłącznie sekcje pliku zawierające zmiany. Widzimy tylko jeden element, ponieważ to dość prosty przykład. Elementy charakteryzują się specyficzną semantyką danych wyjściowych.

Pierwszy wiersz to nagłówek fragmentu. Każdy fragment jest poprzedzony nagłówkiem zawartym między symbolami @@. Zawartość nagłówka jest podsumowaniem zmian wprowadzonych w pliku. W naszym uproszczonym przykładzie widzimy „-1 +1”, co oznacza, że zmiany wprowadzono w pierwszym wierszu. W przypadku rzeczywistego wykazu nagłówek będzie wyglądał w ten sposób:

W powyższym przykładzie zostało wyodrębnionych 6 wierszy, zaczynając od wiersza nr 34. Dodatkowo dodano 8 wierszy, zaczynając od wiersza nr 34.

Pozostałą treść elementu wykazu stanowią ostatnie zmiany. Każdy zmieniony wiersz jest poprzedzony symbolem + lub - wskazującym, z którego pliku źródłowego pochodzą zmiany. Jak wspomnieliśmy wcześniej, - oznacza zmiany z pliku a/diff_test.txt, a + oznacza zmiany z pliku b/diff_test.txt.

Teraz wyświetlone zostają wyłącznie oznaczone kolorami zwroty, które uległy zmianie.

Gdy sklonujemy źródło git, otrzymamy podkatalog o nazwie contrib. Zawiera on kilka narzędzi systemowych oraz inne interesujące elementy jeszcze niewłączone do trzonu systemu Git. Jednym z nich jest skrypt Perl o nazwie diff-highlight. Diff-highlight zestawia pasujące wiersze wykazu różnic i wyróżnia fragmenty zmienionych podsłów.

W ten sposób ograniczamy wykaz do możliwie najmniejszego zakresu zmian.

System Git umożliwia określenie polecenia powłoki, które przekształci zawartość plików binarnych w tekst przed utworzeniem wykazu różnic. Wymaga to jednak wprowadzenia drobnych zmian konfiguracyjnych. Po pierwsze należy określić filtr textconv opisujący sposób konwersji określonego typu plików binarnych na tekst. My używamy prostego narzędzia pdftohtml (dostępnego za pośrednictwem homebrew) do konwersji plików PDF na czytelny dla człowieka kod HTML. Można to ustawić dla pojedynczego repozytorium przez edycję pliku .git/config lub globalnie przez edycję ~ /.gitconfig.

Następnie wystarczy powiązać jeden lub więcej wzorców plików z naszym filtrem pdfconv. Możemy to zrobić przez utworzenie pliku .gitattributes w katalogu głównym repozytorium.

Gdy będą wprowadzone odpowiednie zmiany konfiguracji, git diff najpierw uruchomi plik binarny za pośrednictwem skonfigurowanego skryptu konwertera, a następnie wyświetli wykaz zmian w danych wyjściowych konwertera. Tę samą technikę można zastosować do wydobycia użytecznych różnic ze wszelkiego rodzaju plików binarnych, np. plików .zip, .jar i innych archiwów. Użycie polecenia unzip -l (lub podobnego) zamiast pdf2html spowoduje wyświetlenie ścieżek, które zostały dodane lub usunięte między commitami. Exiv2 można użyć do wykazania zmian w metadanych takich jak wymiary obrazów. Istnieją też narzędzia do konwersji plików .odf, .doc i innych formatów dokumentów na zwykły tekst. W przypadku plików binarnych nieobsługiwanych przez formalny konwerter często sprawdzają się ciągi znaków.

W tym przykładzie zakres działania zostaje ograniczony do ./path/to/file. Po wywołaniu funkcja dokonuje porównania konkretnych zmian w katalogu roboczym względem indeksu, wykazując te jeszcze nieprzeniesione do przechowalni. Domyślnie git diff przeprowadzi porównanie względem HEAD. Pominięcie HEAD w powyższym przykładzie git diff ./path/to/file da ten sam efekt.

Jeśli polecenie git diff zostaje wywołane z opcją --cached, wówczas porównuje zmiany w przechowalni z repozytorium lokalnym. Opcja --cached odpowiada opcji --staged.

Wywołanie git diff bez ścieżki pliku spowoduje porównanie zmian w całym repozytorium. Powyższe przykłady dotyczące poszczególnych plików można wykonać bez argumentu ./path/to/file i uzyskać takie same wyniki dla wszystkich plików w lokalnym repozytorium.

Domyślnie git diff wykazuje wszystkie niezatwierdzone zmiany od ostatniego commitu.

Do polecenia git diff można przekazać odniesienia Git do commitów. Przykładowe odniesienia to wskaźnik HEAD, tagi czy nazwy gałęzi. Każdy commit w Git ma identyfikator, który można uzyskać za pomocą GIT LOG. Identyfikator commitu można również przekazać do polecenia git diff.

W tym przykładzie zostaje wprowadzony operator w postaci kropek. Dwie kropki oznaczają, że danymi wejściowymi polecenia diff są końcówki obu gałęzi. Ten sam efekt nastąpi, jeśli pominiemy kropki i zastosujemy spację między gałęziami. Dodatkowo istnieje operator w postaci trzech kropek:

Trzy kropki wywołują wykaz różnic przez zmianę pierwszego parametru wejściowego branch1. Następuje zmiana branch1 w odniesienie do commitu współdzielonego elementu nadrzędnego między dwiema danymi wejściowymi wykazu — wspólnego elementu nadrzędnego branch1 oraz gałęzi other-feature-branch. Ostatni parametr wejściowy pozostaje niezmieniony jako końcówka gałęzi other-feature-branch.