Git log: elencare e ricercare i commit di un progetto

Git log vi dà la pos­si­bi­li­tà di vi­sua­liz­za­re tutti i commit di un progetto e di filtrarli. A seconda delle istru­zio­ni da voi spe­ci­fi­ca­te potete ottenere risultati migliori.

Il comando git commit è tra i prin­ci­pa­li di ogni tutorial su Git e serve in poche parole a scattare delle istan­ta­nee dei progressi fatti e a far sì che le modifiche vengano salvate cor­ret­ta­men­te. So­prat­tut­to nel caso di progetti di grandi di­men­sio­ni, a cui spesso lavorano grandi team, si ricorre so­li­ta­men­te a mol­te­pli­ci commit, rendendo la cro­no­lo­gia delle versioni alquanto in­de­ci­fra­bi­le. Poiché il comando Git git log vi consente di creare un elenco dei commit, di filtrarli e di ri­cer­car­li in base alle modifiche applicate, rap­pre­sen­ta uno strumento chiave per lavorare con il sistema di controllo delle versioni. Mentre git status serve a esaminare la directory di lavoro, git log si concentra solo sui commit eseguiti.

La sintassi di base di git log è molto semplice. Senza ulteriori in­di­ca­zio­ni il comando elenca i commit del vostro progetto in ordine cro­no­lo­gi­co inverso. Potete quindi scorrere uno alla volta dai commit più recenti a quelli più vecchi. Tra le altre in­for­ma­zio­ni, sono anche elencati la data, il nome e l’indirizzo e-mail del ri­spet­ti­vo utente.

Questa fun­zio­na­li­tà è spe­cial­men­te utile per ottenere un riepilogo generale. Tuttavia, vale sempre la pena di per­fe­zio­na­re i criteri di ricerca per ottenere risultati migliori, spe­cial­men­te quando si tratta di progetti di grandi di­men­sio­ni. A questo scopo Git offre numerose pos­si­bi­li­tà. Abbiamo raccolte per voi in una tabella da con­sul­ta­re quelle più utili, in aggiunta alla pratica guida “Git Cheat Sheet” sca­ri­ca­bi­le in PDF.

Se volete, avete anche la pos­si­bi­li­tà di combinare diverse variabili ed eseguire così una ricerca ancora più precisa. Nel codice che segue vedete un semplice esempio di un elenco specifico con git log. Con il seguente comando potete vi­sua­liz­za­re in dettaglio solamente i commit dell’autore “Mario Rossi” presenti nel file “esempio”.

Per fare un esempio più specifico mettiamo che solo i commit del già citato utente e quelli di una collega siano da con­si­de­ra­re per il periodo compreso tra settembre e ottobre 2021. Inoltre, i commit dovranno pre­sen­ta­re solo modifiche testuali e non dovranno essere fusioni (merges). In questo caso il codice sarà il seguente:

Con i formati pretty potete impostare la modalità di vi­sua­liz­za­zio­ne di git log. I formati più comuni sono i seguenti:

• oneline: mostra tutte le in­for­ma­zio­ni in una riga.
• short: elenca solamente i commit, l’autore o l’autrice e il titolo.
• medium: elenca i commit, l’autore o l’autrice, la data, il titolo e la de­scri­zio­ne.
• full: aggiunge ai pre­ce­den­ti anche il committer.
• fuller: elenca in aggiunta la data dell’autore o dell’autrice e del committer.
• email: mostra le in­for­ma­zio­ni nel formato e-mail.
• raw: elenca i commit esat­ta­men­te come sono stati eseguiti.
• format: permette di eseguire una for­mat­ta­zio­ne per­so­na­liz­za­ta; per esempio ri­por­tan­do le in­for­ma­zio­ni rilevanti all’interno di una frase, in­clu­den­do paragrafi o im­po­stan­do un ordine di lettura specifico.

Git log è uno strumento fon­da­men­ta­le per mantenere una visione d’insieme del vostro progetto e per filtrare de­ter­mi­na­te in­for­ma­zio­ni. Il comando viene spesso uti­liz­za­to con­giun­ta­men­te a git diff per­met­ten­do di elencare le modifiche tra due commit. Questo non solo vi permette di vedere chia­ra­men­te come il progetto si sia svi­lup­pa­to nel tempo e quali membri del team stanno lavorando a un preciso compito, ma è anche utile per iden­ti­fi­ca­re eventuali fonti di errore.