Cosa fa git rev-parse?

Cosa fa git rev-parse?

Ho letto la pagina man ma ha sollevato più domande che risposte. Cose come:

Scegli e massaggia i parametri

Massaggi ? Cosa significa?

Sto usando come risolutore (a SHA1) di specificatori di revisione, come

git rev-parse HEAD^

o

git rev-parse origin/master

È questo lo scopo del comando? In caso contrario, è anche corretto usarlo per raggiungere questo obiettivo?

git rev-parseè un plumbingcomando accessorio utilizzato principalmente per la manipolazione.

Un uso comune di git rev-parseè stampare gli hash SHA1 con un identificatore di revisione. Inoltre, ha varie opzioni per formattare questo output, ad esempio --shortper stampare un SHA1 unico più corto.

Ci sono anche altri casi d'uso (negli script e altri strumenti basati su git) che ho usato per:

• --verify per verificare che l'oggetto specificato sia un oggetto git valido.
• --git-dirper visualizzare il percorso abs / relativo della .gitdirectory.
• Verifica se sei attualmente all'interno di un repository utilizzando --is-inside-git-diro all'interno di un albero di lavoro utilizzando--is-inside-work-tree
• Verifica se il repository è un utilizzo nudo --is-bare-repository
• La stampa di hash SHA1 di rami ( --branches), tag ( --tags) e ref può anche essere filtrata in base al telecomando (usando --remote)
• --parse-optper normalizzare gli argomenti in uno script (in qualche modo simile a getopt) e stampare una stringa di output che può essere utilizzata coneval

Massageimplica solo che è possibile convertire le informazioni da un modulo in un altro, cioè un comando di trasformazione. Questi sono alcuni brevi esempi che mi vengono in mente:

• un nome di ramo o tag nello SHA1 del commit a cui punta in modo che possa essere passato a un comando idraulico che accetta solo i valori SHA1 per il commit.
• un intervallo di revisione A..Bper git logo git diffnegli argomenti equivalenti per il comando idraulico sottostante comeB ^A

Giusto per elaborare l'etimologia del nome del comando rev-parse, Git usa costantemente il termine revnei comandi idraulici come abbreviazione di "revisione" e in genere significa l'hash SHA1 di 40 caratteri per un commit. Ad rev-listesempio, il comando stampa un elenco di hash di commit da 40 caratteri per un ramo o altro.

In questo caso il nome potrebbe essere espanso in parse-a-commitish-to-a-full-SHA1-hash. Mentre il comando ha le varie funzioni ausiliarie menzionate nella risposta di Tuxdude, il suo omonimo sembra essere il caso d'uso di trasformare un riferimento intuitivo come un nome di ramo o un hash abbreviato nell'ambiguo hash SHA1 di 40 caratteri più utile per molte programmazioni / impianti idraulici scopi.

So che stavo pensando che fosse qualcosa di "reverse-parse" per un bel po 'di tempo prima che lo capissi e avessi lo stesso problema nel dare un senso ai termini "massaggiare" e "manipolazione" :)

Ad ogni modo, trovo che questa nozione di "analisi da una revisione" sia un modo soddisfacente per pensarci, e un concetto affidabile per ricordare questo comando quando ho bisogno di quel genere di cose. Spesso negli script Git si prende un riferimento di commit intuitivo come input dell'utente e generalmente si desidera che venga risolto in un riferimento di lavoro convalidato e non ambiguo non appena ricevuto. Altrimenti la traduzione e la convalida dell'input tendono a proliferare attraverso la sceneggiatura.

git rev-parseFunziona anche per ottenere il nome del ramo corrente usando il flag --abbrev-ref come:

git rev-parse --abbrev-ref HEAD