Git Status: ispezione di un repository

Il comando git status è un comando relativamente semplice. Ti mostra semplicemente cosa sta succedendo con git add e git commit. I messaggi di stato includono anche istruzioni pertinenti per i file di staging/destaging. Di seguito è riportato un esempio di output che mostra le tre categorie principali di una chiamata di git status:

I file non tracciati in genere rientrano in due categorie. Sono file che sono appena stati aggiunti al progetto e non sono ancora stati salvati, oppure sono file binari compilati come .pyc, .obj, .exe, ecc. Sebbene sia sicuramente utile includere il primo nell'output di git status, il secondo può rendere difficile vedere cosa sta effettivamente succedendo nel tuo repository.

Per questo motivo, Git ti consente di ignorare completamente i file inserendo i percorsi in un file speciale chiamato .gitignore. Tutti i file che desideri ignorare devono essere inclusi in una riga separata e il simbolo * può essere usato come jolly. Ad esempio, aggiungendo quanto segue a un file .gitignore il file nella cartella principale del tuo progetto impedirà ai moduli Python compilati di apparire in git status:

The first status output will show the file as unstaged. The git add action will be reflected in the second git status, and the final status output will tell you that there is nothing to commit—the working directory matches the most recent commit. Some Git commands (e.g., git merge) require the working directory to be clean so that you don't accidentally overwrite changes.

L'output del registro può essere personalizzato in diversi modi, dal semplice filtraggio dei commit alla loro visualizzazione in un formato completamente definito dall'utente. Alcune delle configurazioni più comuni di git log sono presentate di seguito.

Visualizza l'intera cronologia dei commit utilizzando la formattazione predefinita. Se l'output occupa più di una schermata, puoi usare la barra spaziatrice per scorrere e q per uscire.

Limita il numero di commit per . Ad esempio, git log -n 3 mostrerà solo 3 commit.

Riduci ogni commit a un'unica riga. Questo è molto utile per avere una panoramica generale sul tuo progetto.

Oltre alle normali informazioni di git log, includi quali file sono stati modificati e il numero relativo di righe che sono state aggiunte o eliminate da ciascuno di essi.

Visualizza la patch che rappresenta ogni commit. Mostra la differenza completa di ogni commit, che è la visualizzazione più dettagliata che puoi avere della cronologia del tuo progetto.

Search for commits by a particular author. The ＜pattern＞ argument can be a plain string or a regular expression.

Search for commits with a commit message that matches ＜pattern＞, which can be a plain string or a regular expression.

Mostra solo i commit che si verificano tra e . Entrambi gli argomenti possono essere un ID di commit, il nome di un branch, HEAD o qualsiasi altro tipo di riferimento di revisione.

Visualizza solo i commit che includono il file specificato. Questo è un modo semplice per visualizzare la cronologia di un determinato file.

Alcune opzioni utili da considerare. Il flag —graph che disegnerà un grafico testuale dei commit sul lato sinistro dei messaggi di commit. —decorate aggiunge i nomi dei branch o dei tag dei commit mostrati. —oneline mostra le informazioni sui commit su un'unica riga, semplificando la navigazione tra i commit a colpo d'occhio.

5. Controlla lo stato del file.

La maggior parte di questo è piuttosto semplice; tuttavia, la prima riga merita qualche spiegazione. La stringa di 40 caratteri dopo il commit è un checksum SHA-1 del contenuto del commit. Questo ha due scopi. Innanzitutto, garantisce l'integrità del commit: se mai fosse danneggiato, il commit genererebbe un checksum diverso. In secondo luogo, funge da ID univoco per il commit.

Questo ID può essere utilizzato in comandi come git log .. per fare riferimento a commit specifici. Ad esempio, git log 3157e.. 5ab91 mostrerà tutto ciò che è compreso tra i commit con ID 3157e e 5ab91. Oltre ai checksum, i nomi dei branch (discussi nel Modulo Branch) e la parola chiave HEAD sono altri metodi comuni per fare riferimento ai singoli commit. HEAD si riferisce sempre al commit corrente, che si tratti di un branch o di un commit specifico.

Il carattere ~ è utile per creare riferimenti relativi all'elemento padre di un commit. Ad esempio, 3157e~1 si riferisce al commit prima di 3157e e HEAD~3 è l'elemento superiore di tre livelli del commit corrente.

La sezione Utilizzo fornisce molti esempi di git log, ma tieni presente che diverse opzioni possono essere combinate in un unico comando:

Verrà visualizzata una differenza completa di tutte le modifiche apportate da John Smith al file hello.py.

La sintassi ... è uno strumento molto utile per confrontare i branch. Il prossimo esempio mostra una breve panoramica di tutti i commit presenti in alcune funzionalità che non sono nella sezione principale.