git-blame - Online nel cloud

PROGRAMMA:

NOME

git-blame - Mostra quale revisione e autore hanno modificato l'ultima riga di un file

SINOSSI

git colpa [-c] [-b] [-l] [--root] [-t] [-f] [-n] [-s] [-e] [-p] [-w] [--incrementale]
[-L ] [-S ] [-M] [-C] [-C] [-C] [--da= ]
[--abbrev= ] [ | --Contenuti | --inversione ] [--]

DESCRIZIONE

Annota ogni riga nel file dato con le informazioni della revisione che è stata l'ultima
modificato la linea. Facoltativamente, inizia ad annotare dalla revisione data.

Quando viene specificato una o più volte, -L limita l'annotazione alle righe richieste.

L'origine delle lineeèseguita automaticamente attraverso le rinomine di interi file (attualmente lì
non c'è alcuna opzione per disattivare l'inseguimento di rinomina). Per seguire le righe spostate da un file a
un altro, o per seguire le righe che sono state copiate e incollate da un altro file, ecc., vedere il
-C e -M opzioni.

Il report non ti dice nulla sulle linee che sono state cancellate o sostituite; tu
bisogno di utilizzare uno strumento come git diff o l'interfaccia "piccone" brevemente menzionata nel
paragrafo successivo.

Oltre a supportare l'annotazione dei file, Git supporta anche la ricerca nella cronologia di sviluppo
per quando un frammento di codice si è verificato in una modifica. Ciò consente di monitorare quando un codice
lo snippet è stato aggiunto a un file, spostato o copiato tra i file e infine eliminato o
sostituito. Funziona cercando una stringa di testo nel file diff. Un piccolo esempio di
interfaccia di piccone che cerca il nome di biasimo_usage:

$ git log --pretty=oneline -S'blame_usage'
5040f17eba15504bad66b14a645bddd9b015ebb7 blame -S <ancestry-file>
ea4c7f9bf69e781dd0cd88d2bccb2bf5cc15c9a7 git-blame: Make the output

VERSIONI

-b
Mostra SHA-1 vuoto per i commit di limite. Questo può essere controllato anche tramite il
opzione di configurazione di colpa.blankboundary.

--radice
Non trattare i commit di root come limiti. Questo può essere controllato anche tramite il
opzione di configurazione di colpa.showRoot.

--show-statistiche
Includere statistiche aggiuntive alla fine dell'output della colpa.

-L , , -L :
Annota solo l'intervallo di righe specificato. Può essere specificato più volte. sovrapposizione
gli intervalli sono consentiti.

e sono opzionali. “-L ” o “-L ”, si estende da a
fine del file. “-L, ” si estende dall'inizio del file a .

e può assumere una di queste forme:

· numero

Se o è un numero, specifica un numero di riga assoluto (conta righe
dal 1).

· /espressione regolare/

Questo modulo utilizzerà la prima riga che corrisponde alla data regex POSIX. Se è un
regex, cercherà dalla fine dell'intervallo -L precedente, se presente, altrimenti
dall'inizio del file. Se è "^/regex/", cercherà dall'inizio di
file. Se è un'espressione regolare, cercherà a partire dalla riga data da .

· +offset o -offset

Questo è valido solo per e specificherà un numero di righe prima o dopo
la linea data da .

Se ": "è dato al posto di e , è un'espressione regolare
che denota l'intervallo dalla prima riga funcname che corrisponde , fino a
riga del nome della funzione successiva. “: ” ricerca dalla fine dell'intervallo -L precedente, se
any, altrimenti dall'inizio del file. “^: ” ricerca dall'inizio del file.

-l
Mostra giro lungo (predefinito: disattivato).

-t
Mostra timestamp non elaborato (predefinito: disattivato).

-S
Usa le revisioni dal file revs invece di chiamare elenco-git-rev(1).

--inversione
Sposta la cronologia in avanti anziché indietro. Invece di mostrare la revisione in cui a
è apparsa la riga, mostra l'ultima revisione in cui è esistita una riga. Questo richiede
un intervallo di revisioni come START..END in cui il percorso da incolpare esiste in START.

-p, --porcellana
Mostra in un formato progettato per il consumo della macchina.

--line-porcellana
Mostra il formato porcellana, ma emetti le informazioni di commit per ogni riga, non solo per il
la prima volta che si fa riferimento a un commit. Implica --porcellana.

--incrementale
Mostra il risultato in modo incrementale in un formato progettato per il consumo della macchina.

--codifica=
Specifica la codifica utilizzata per l'output dei nomi degli autori e dei riepiloghi di commit. Impostandolo su
nessuno dà la colpa all'output dei dati non convertiti. Per maggiori informazioni vedi la discussione
sulla codifica in git log(1) pagina di manuale.

--Contenuti
quando non è specificato, il comando annota le modifiche partendo a ritroso da
la copia dell'albero di lavoro. Questo flag fa sembrare il comando come se l'albero di lavoro copiasse
ha il contenuto del file nominato (specificare - per fare in modo che il comando venga letto dal
ingresso standard).

--Data
Specifica il formato utilizzato per l'output delle date. Se --date non viene fornito, il valore di
Viene utilizzata la variabile di configurazione colpa.date. Se anche la variabile di configurazione colpa.date non è impostata,
viene utilizzato il formato iso. Per i valori supportati, vedere la discussione sull'opzione --date
at git log(1).

-M| |
Rileva le righe spostate o copiate all'interno di un file. Quando un commit sposta o copia un blocco di
righe (ad esempio il file originale ha A e poi B, e il commit lo cambia in B e
poi A), il tradizionale colpa l'algoritmo rileva solo la metà del movimento e
in genere incolpa le linee che sono state spostate verso l'alto (cioè B) al genitore e assegna la colpa
alle righe che sono state spostate in basso (ad esempio A) al commit figlio. Con questa opzione, entrambi
i gruppi di linee vengono incolpati del genitore eseguendo passaggi di ispezione aggiuntivi.

è facoltativo ma è il limite inferiore del numero di caratteri alfanumerici
che Git deve rilevare come spostamento/copia all'interno di un file per associare quelle righe
con il commit genitore. Il valore predefinito è 20.

-C| |
Oltre a -M, rileva le righe spostate o copiate da altri file che sono stati modificati in
lo stesso impegno. Questo è utile quando riorganizzi il tuo programma e sposti il ​​codice in giro
tra file. Quando questa opzione viene data due volte, il comando cerca anche
copie da altri file nel commit che crea il file. Quando viene data questa opzione
tre volte, il comando cerca inoltre copie da altri file in qualsiasi commit.

è facoltativo ma è il limite inferiore del numero di caratteri alfanumerici
che Git deve rilevare come spostamento/copia tra file per associare quelle righe
con il commit genitore. E il valore predefinito è 40. Se sono presenti più di un -C
opzioni date, il l'argomento dell'ultimo -C avrà effetto.

-h
Mostra messaggio di aiuto.

-c
Usa la stessa modalità di uscita di git-annotazione(1) (Predefinito: spento).

--score-debug
Includere le informazioni di debug relative allo spostamento delle linee tra i file (vedi -C)
e le righe spostate all'interno di un file (vedi -M). Il primo numero elencato è il punteggio. Questo è
il numero di caratteri alfanumerici rilevati come spostati tra o entro
File. Questo deve essere al di sopra di una certa soglia per git colpa considerare quelle linee di
codice per essere stato spostato.

-f, --mostra-nome
Mostra il nome del file nel commit originale. Per impostazione predefinita viene mostrato il nome del file se c'è
qualsiasi riga proveniente da un file con un nome diverso, a causa del rilevamento della ridenominazione.

-n, --mostra-numero
Mostra il numero di riga nel commit originale (predefinito: disattivato).

-s
Elimina il nome dell'autore e il timestamp dall'output.

-e, --show-e-mail
Mostra l'e-mail dell'autore invece del nome dell'autore (impostazione predefinita: disattivata). Questo può anche essere
controllato tramite l'opzione di configurazione di colpa.showEmail.

-w
Ignora gli spazi bianchi quando confronti la versione del genitore e quella del bambino per trovare dove
le linee provenivano.

--abbrev=
Invece di utilizzare le cifre esadecimali 7+1 predefinite come nome dell'oggetto abbreviato,
utilizzo +1 cifre. Nota che 1 colonna viene utilizzata per un accento circonflesso per contrassegnare il commit del limite.

LA PORCELLANA FORMATO

In questo formato, ogni riga viene emessa dopo un'intestazione; l'intestazione al minimo ha il
prima riga che ha:

· SHA-40 a 1 byte del commit a cui è attribuita la linea;

· il numero di riga della riga nel file originale;

· il numero di riga della riga nel file finale;

· su una riga che inizia un gruppo di righe da un commit diverso da quello precedente,
il numero di righe in questo gruppo. Nelle righe successive questo campo è assente.

Questa riga di intestazione è seguita dalle seguenti informazioni almeno una volta per ogni commit:

· il nome dell'autore ("autore"), l'e-mail ("posta dell'autore"), l'ora ("ora dell'autore") e il fuso orario
("autore-tz"); allo stesso modo per committente.

· il nome del file nel commit a cui è attribuita la riga.

· la prima riga del messaggio di log di commit ("summary").

Il contenuto della riga effettiva viene emesso dopo l'intestazione precedente, preceduta da un TAB. Questo
è quello di consentire l'aggiunta di più elementi di intestazione in un secondo momento.

Il formato porcellana generalmente sopprime le informazioni di commit che sono già state viste.
Ad esempio, verranno mostrate due righe attribuite allo stesso commit, ma il
i dettagli per quel commit verranno mostrati solo una volta. Questo è più efficiente, ma potrebbe richiedere
più stato essere mantenuto dal lettore. L'opzione --line-porcelain può essere utilizzata per l'output completo
commit delle informazioni per ogni riga, consentendo un utilizzo più semplice (ma meno efficiente) come:

# conta il numero di righe attribuite a ciascun autore
git colpa --line-porcelain file |
sed -n 's/^autore //p' |
ordina | uniq -c | sort -rn

SPECIFICANDO GAMME

a differenza di git colpa ed git annotare nelle versioni precedenti di git, l'estensione dell'annotazione
può essere limitato sia agli intervalli di linea che agli intervalli di revisione. L'opzione -L, che limita
l'annotazione a un intervallo di righe, può essere specificata più volte.

Quando sei interessato a trovare l'origine per le righe 40-60 per il file foo, puoi usare
l'opzione -L in questo modo (significano la stessa cosa: entrambi chiedono 21 righe che iniziano per riga
40):

git colpa -L 40,60 pippo
git colpa -L 40,+21 pippo

Inoltre puoi usare un'espressione regolare per specificare l'intervallo di righe:

git colpa -L '/^sub ciao {/,/^}$/' foo

che limita l'annotazione al corpo della subroutine ciao.

Quando non sei interessato alle modifiche precedenti alla versione v2.6.18 o alle modifiche precedenti alla 3
settimane, è possibile utilizzare identificatori dell'intervallo di revisione simili a git rev-lista:

git colpa v2.6.18.. -- foo
git colpa --since=3.weeks -- foo

Quando gli specificatori dell'intervallo di revisione vengono utilizzati per limitare l'annotazione, le righe che non lo hanno
cambiato dal limite dell'intervallo (o il commit v2.6.18 o il commit più recente che
ha più di 3 settimane nell'esempio precedente) sono incolpati per quel commit di limite di intervallo.

Un modo particolarmente utile è vedere se un file aggiunto ha linee create tramite copia e incolla
da file esistenti. A volte questo indica che lo sviluppatore era negligente e lo ha fatto
non rifattorizzare correttamente il codice. Puoi prima trovare il commit che ha introdotto il file
con:

git log --diff-filter=A --pretty=short --foo

e poi annota il cambiamento tra il commit ei suoi genitori, usando commit^! notazione:

git colpa -C -C -f $commit^! -- pippo

INCREMENTALE USCITA

Quando viene chiamato con l'opzione --incremental, il comando emette il risultato così come viene compilato. Il
l'output generalmente parlerà per prime delle righe toccate da commit più recenti (cioè il
le righe saranno annotate fuori ordine) ed è pensato per essere utilizzato da visualizzatori interattivi.

Il formato di output è simile al formato Porcelain, ma non contiene l'effettivo
righe dal file che viene annotato.

1. Ogni voce di colpa inizia sempre con una riga di:

<40 byte esadecimale sha1>

I numeri di riga contano da 1.

2. La prima volta che viene visualizzato un commit nello stream, contiene varie altre informazioni
a riguardo stampato con un tag di una parola all'inizio di ogni riga che descrive il
informazioni extra sul commit (autore, email, committer, date, riepilogo, ecc.).

3. A differenza del formato Porcelain, le informazioni sul nome del file sono sempre fornite e terminano
l'entrata:

"nome del file"

e quindi è davvero abbastanza facile analizzare alcuni parser orientati alle righe e alle parole
(che dovrebbe essere abbastanza naturale per la maggior parte dei linguaggi di scripting).

Note:
Per le persone che eseguono l'analisi: per renderlo più robusto, ignora semplicemente le linee tra
il primo e l'ultimo (" " e "filename") dove non riconosci
le parole del tag (o cura di quella particolare) all'inizio del
righe "informazioni estese". In questo modo, se vengono aggiunte informazioni (come
la codifica del commit o il commento esteso del commit), un osservatore di colpa non si preoccuperà.

MAPPATURA AUTORI

Se il file .mailmap esiste al livello più alto del repository o nella posizione indicata
dalle opzioni di configurazione mailmap.file o mailmap.blob, viene utilizzato per mappare l'autore e
nomi e indirizzi e-mail di committer a nomi reali e indirizzi e-mail canonici.

Nella forma semplice, ogni riga del file è costituita dal nome reale canonico di an
autore, spazi bianchi e un indirizzo email utilizzato nel commit (racchiuso da < ed >) mappare
al nome. Per esempio:

Nome proprio[email protected]>

Le forme più complesse sono:

<[email protected]>[email protected]>

che consente a mailmap di sostituire solo la parte email di un commit e:

Nome proprio[email protected]>[email protected]>

che consente a mailmap di sostituire sia il nome che l'e-mail di un commit che corrisponde al
indirizzo email di commit specificato e:

Nome proprio[email protected]> Nome commit[email protected]>

che consente a mailmap di sostituire sia il nome che l'e-mail di un commit che corrisponde a entrambi
nome commit e indirizzo email specificati.

Esempio 1: la tua cronologia contiene commit di due autori, Jane e Joe, i cui nomi compaiono
nel repository sotto diverse forme:

Joe Sviluppatore[email protected]>
Joe R. Sviluppatore[email protected]>
Jane Doe[email protected]>
Jane Doe
Jane D.

Supponiamo ora che Joe voglia usare l'iniziale del suo secondo nome e che Jane preferisca il suo cognome
completamente enunciato. Un file .mailmap corretto sarebbe simile a:

Jane Doe
Joe R. Sviluppatore[email protected]>

Nota come non è necessaria una voce per , perché il vero nome di
quell'autore ha già ragione.

Esempio 2: il tuo repository contiene commit dei seguenti autori:

nick1[email protected]>
nick2[email protected]>
nick2[email protected]>
babbo natale[email protected]>
claus[email protected]>
CTO[email protected]>

Quindi potresti volere un file .mailmap che assomigli a:

<[email protected]>[email protected]>
alcuni tizio[email protected]> nick1[email protected]>
Altro autore[email protected]> nick2[email protected]>
Altro autore[email protected]>[email protected]>
Babbo Natale[email protected]>[email protected]>

Usa hash # per i commenti che si trovano sulla propria riga o dopo l'indirizzo e-mail.

Usa git-blame online usando i servizi onworks.net