Polecenie git log --stat: Jak efektywnie śledzić historię repozytorium

Jeśli pracujesz z Git, to na pewno niejednokrotnie musiałeś zapoznać się z historią zmian w repozytorium. Git oferuje szereg poleceń, które umożliwiają efektywne śledzenie postępów pracy, a jednym z najbardziej przydatnych narzędzi do analizy historii jest git log --stat. W tym artykule przyjrzymy się, jak działa to polecenie, do czego się przydaje i jakie daje możliwości w zarządzaniu kodem.

Co to jest polecenie git log --stat?

W skrócie, polecenie git log --stat jest rozszerzoną wersją klasycznego polecenia git log, które wyświetla historię commitów w Twoim repozytorium. Zwykły git log pokazuje listę commitów, zawierającą takie informacje jak identyfikator commita, autora, datę i wiadomość commitową. Z kolei git log --stat rozszerza tę funkcję o dodatkowe szczegóły — szczególnie dotyczące zmian, które zostały wprowadzone w poszczególnych commitach, czyli pokazuje m.in. jakie pliki zostały zmodyfikowane, jak wiele linii zostało dodanych i usuniętych w każdym z tych plików.

Można powiedzieć, że git log --stat dostarcza nam o wiele pełniejszy obraz historii projektu, umożliwiając szybkie śledzenie, jakie zmiany miały miejsce w repozytorium bez konieczności zagłębiania się w szczegóły poszczególnych commitów.

Dlaczego warto używać git log --stat?

Dlaczego więc warto stosować to polecenie? Oto kilka powodów, dla których git log --stat jest tak przydatnym narzędziem:

• Śledzenie zmian w plikach: Widzisz, jakie pliki zostały zmodyfikowane i w jakim zakresie, co może być niezwykle pomocne przy analizie postępu pracy nad projektem.
• Szybka analiza commitów: Dzięki --stat możesz szybko przeanalizować, ile linii kodu zostało dodanych lub usuniętych w każdym commicie, co daje lepszy wgląd w zmiany.
• Pomoc przy rozwiązywaniu problemów: Jeśli napotkasz błąd, polecenie to pomoże Ci znaleźć commit, który wprowadził problematyczne zmiany, oraz określić, które pliki były zaangażowane.
• Lepsze zarządzanie wersjami: Dzięki możliwości zobaczenia, jak wiele zmian zostało wprowadzonych do plików, łatwiej zarządzać wersjami i podejmować decyzje o dalszym rozwoju projektu.

Jak używać git log --stat?

Teraz, gdy wiemy, dlaczego warto korzystać z git log --stat, czas przyjrzeć się, jak dokładnie używać tego polecenia. Jest to bardzo proste, a jego składnia wygląda następująco:

git log --stat

Po wpisaniu tego polecenia Git wyświetli historię commitów w repozytorium, a dla każdego commita pokaże następujące informacje:

• Identifikator commita
• Autor i data commita
• Wiadomość commitowa
• Lista zmodyfikowanych plików
• Liczba dodanych i usuniętych linii w każdym pliku

Przykład użycia:

commit 9b2d0f8c58c4536f945e7f65ec3c567b281ae869
Author: Jan Kowalski 
Date:   Mon Mar 1 12:00:00 2023 +0100

    Added new feature to the user login system

 docs/login.md |  10 +++++-----
 src/user.c   |  15 +++++++++++++++
 2 files changed, 22 insertions(+), 3 deletions(-)

W tym przykładzie widać, że w pierwszym pliku docs/login.md zostało dodanych 10 linii i usuniętych 3, a w pliku src/user.c dodano 15 nowych linii kodu. Dzięki tym informacjom możemy szybko zorientować się, jak duża była zmiana i które pliki zostały zmodyfikowane.

Przykłady użycia git log --stat

Aby pokazać pełny potencjał polecenia git log --stat, przeanalizujmy kilka przykładów użycia w różnych scenariuszach:

Przykład 1: Przeglądanie pełnej historii commitów

Najprostszym przypadkiem jest po prostu chęć zobaczenia wszystkich zmian w projekcie. W tym przypadku wystarczy użyć:

git log --stat

To wyświetli pełną historię commitów wraz z danymi o zmianach w plikach. Jest to przydatne, jeśli chcesz uzyskać ogólny wgląd w to, co działo się w projekcie, jakie pliki były najczęściej modyfikowane itp.

Przykład 2: Przeglądanie zmian w określonym pliku

Czasami interesują Cię tylko zmiany, które dotyczyły konkretnego pliku. W takim przypadku możesz ograniczyć zakres polecenia git log --stat do jednego pliku:

git log --stat src/user.c

W ten sposób zobaczysz historię commitów tylko dla pliku src/user.c, wraz ze szczegółami dotyczącymi każdej zmiany w tym pliku.

Przykład 3: Ograniczenie liczby commitów

Jeśli chcesz zobaczyć tylko ostatnie zmiany, możesz ograniczyć liczbę wyświetlanych commitów. Na przykład, aby zobaczyć tylko 5 ostatnich commitów, użyj:

git log --stat -n 5

To wyświetli historię tylko pięciu ostatnich commitów, co jest przydatne, jeśli chcesz szybko sprawdzić najnowsze zmiany.

Przykład 4: Wyświetlanie tylko określonych danych

W przypadku, gdy interesują Cię tylko zmiany w liczbie linii, a nie szczegóły dotyczące commitów, możesz użyć polecenia z dodatkowymi opcjami:

git log --stat --oneline

Opcja --oneline sprawi, że każda zmiana zostanie wyświetlona w jednej linii, co sprawi, że wynik będzie bardziej kompaktowy i przejrzysty.

Przykład 5: Filtrowanie commitów na podstawie daty

Czasami potrzebujesz sprawdzić zmiany w określonym przedziale czasowym. W tym celu możesz użyć opcji --since i --until, aby określić zakres dat:

git log --stat --since="2023-01-01" --until="2023-12-31"

To polecenie pokaże Ci zmiany, które miały miejsce w 2023 roku, pomagając skupić się na interesującym Cię okresie.

Podsumowanie

Polecenie git log --stat to potężne narzędzie, które pozwala na efektywne monitorowanie historii zmian w repozytorium Git. Dzięki niemu możesz szybko zobaczyć, które pliki zostały zmodyfikowane, jakie zmiany zostały wprowadzone w każdym z commitów oraz jak dużą skalę miały te zmiany. Bez względu na to, czy jesteś nowicjuszem, czy doświadczonym programistą, git log --stat stanie się niezastąpionym narzędziem w codziennej pracy z Git. Z praktycznymi przykładami w tym artykule powinieneś teraz poczuć się pewnie w jego używaniu i lepiej zarządzać historią swojego repozytorium.