git-interpret-trailers - Online nel cloud

PROGRAMMA:

NOME

git-interpret-trailers - aiuta ad aggiungere informazioni strutturate nei messaggi di commit

SINOSSI

git interpreti-trailer [--trim-empty] [(--trailer [(=|:) ])...] [ ...]

DESCRIZIONE

Aiuto per l'aggiunta rimorchi linee, che sembrano simili alle intestazioni di posta elettronica RFC 822, alla fine del
altrimenti parte in formato libero di un messaggio di commit.

Questo comando legge alcune patch o invia messaggi di commit da argomenti o il
ingresso standard se no è specificato. Quindi questo comando applica gli argomenti passati
utilizzando l'opzione --trailer, se presente, nella parte del messaggio di commit di ciascun file di input. Il
il risultato viene emesso sullo standard output.

Alcune variabili di configurazione controllano il modo in cui gli argomenti --trailer vengono applicati a ciascuna
messaggio di commit e il modo in cui viene modificato qualsiasi trailer esistente nel messaggio di commit. Essi
consentono inoltre di aggiungere automaticamente alcuni trailer.

Per impostazione predefinita, a = or : argomento dato usando --trailer sarà
aggiunto dopo i trailer esistenti solo se l'ultimo trailer ha un diverso ( ,
) coppia (o se non esiste un trailer esistente). Il e le parti saranno
tagliato per rimuovere lo spazio bianco iniziale e finale e il risultante tagliato e
apparirà nel messaggio in questo modo:

token: valore

Ciò significa che il tagliato e sarà separato da ': ' (un due punti
seguito da uno spazio).

Per impostazione predefinita, il nuovo trailer apparirà alla fine di tutti i trailer esistenti. Se ci
non c'è un trailer esistente, il nuovo trailer apparirà dopo la parte del messaggio di commit del
output e, se non c'è una riga con solo spazi alla fine della parte del messaggio di commit,
verrà aggiunta una riga vuota prima del nuovo trailer.

I trailer esistenti vengono estratti dal messaggio di input cercando un gruppo di uno o
più righe che contengono i due punti (per impostazione predefinita), dove il gruppo è preceduto da uno o più
righe vuote (o solo spazi bianchi). Il gruppo deve essere alla fine del messaggio o essere
le ultime righe senza spazi prima di una riga che inizia con ---. Questi tre segni meno
avviare la parte di patch del messaggio.

Quando si leggono i trailer, possono esserci spazi bianchi prima e dopo il token, il separatore
e il valore. Ci possono essere anche spazi bianchi all'interno del token e del valore.

Si noti che rimorchi non seguono e non intendono seguire molte regole per RFC 822
intestazioni. Ad esempio non seguono le regole di piegatura della linea, le regole di codifica e
probabilmente molte altre regole.

VERSIONI

--trim-vuoto
Se la parte di qualsiasi trailer contiene solo spazi bianchi, l'intero trailer sarà
rimosso dal messaggio risultante. Questo vale sia per i rimorchi esistenti che per quelli nuovi
rimorchi.

--trailer [(=|:) ]
Specificare un ( , ) coppia che va applicata come trailer all'input
messaggi. Vedere la descrizione di questo comando.

CONFIGURAZIONE VARIABILI

trailer.separatori
Questa opzione indica quali caratteri vengono riconosciuti come separatori di coda. Per impostazione predefinita
esclusivamente : è riconosciuto come separatore di rimorchio, tranne che = è sempre accettato sul
riga di comando per la compatibilità con altri comandi git.

Il primo carattere fornito da questa opzione sarà il carattere predefinito utilizzato quando
un altro separatore non è specificato nella configurazione per questo trailer.

Ad esempio, se il valore per questa opzione è "%=$", solo le righe che utilizzano il formato
insieme a contenente %, = or $ e poi verranno considerati gli spazi
rimorchi. e % sarà il separatore predefinito utilizzato, quindi per impostazione predefinita appariranno i trailer
piace: % (tra il token appariranno un segno di percentuale e uno spazio
e il valore).

trailer.dove
Questa opzione indica dove verrà aggiunto un nuovo trailer.

Può essere fine, che è l'impostazione predefinita, inizio, dopo o prima.

Se è la fine, ogni nuovo trailer apparirà alla fine dei trailer esistenti.

Se è start, ogni nuovo trailer apparirà all'inizio, invece che alla fine, di
i rimorchi esistenti.

Se è dopo, ogni nuovo trailer apparirà subito dopo l'ultimo trailer con il
stesso .

Se è prima, ogni nuovo trailer apparirà subito prima del primo trailer con
lo stesso .

trailer.ifesiste
Questa opzione consente di scegliere quale azione verrà eseguita quando c'è
già almeno un trailer con lo stesso nel messaggio.

I valori validi per questa opzione sono: addIfDifferentNeighbor (questo è l'impostazione predefinita),
addIfDifferent, aggiungi, sovrascrivi o non fai niente.

Con addIfDifferentNeighbor, verrà aggiunto un nuovo trailer solo se nessun trailer con il
stesso ( , ) la coppia è sopra o sotto la linea in cui sarà il nuovo trailer
aggiunto.

Con addIfDifferent, verrà aggiunto un nuovo trailer solo se nessun trailer con lo stesso
( , ) la coppia è già nel messaggio.

Con add verrà aggiunto un nuovo trailer, anche se alcuni trailer con lo stesso ( ,
) sono già presenti nel messaggio.

Con la sostituzione, un rimorchio esistente con lo stesso sarà cancellato e il nuovo
rimorchio verrà aggiunto. Il trailer eliminato sarà il più vicino (con lo stesso
) nel luogo in cui verrà aggiunto il nuovo.

Con doNothing, non si farà nulla; questo non è un nuovo trailer verrà aggiunto se c'è
già tutt'uno con lo stesso nel messaggio.

trailer.se manca
Questa opzione consente di scegliere quale azione verrà eseguita quando c'è
non ancora nessun trailer con lo stesso nel messaggio.

I valori validi per questa opzione sono: add (questo è l'impostazione predefinita) e doNothing.

Con add, verrà aggiunto un nuovo trailer.

Con doNothing, non si farà nulla.

trailer. .chiave
Questa chiave verrà utilizzata al posto di nel rimorchio. Alla fine di questo tasto, a
può apparire il separatore e poi alcuni caratteri di spazio. Per impostazione predefinita l'unico valido
separatore è :, ma questo può essere modificato utilizzando la variabile di configurazione trailer.separators.

Se è presente un separatore, verrà utilizzata la chiave al posto di entrambi i e il
separatore predefinito quando si aggiunge il trailer.

trailer. .dove
Questa opzione assume gli stessi valori di trailer.dove variabile di configurazione e
sovrascrive ciò che è specificato da quell'opzione per i rimorchi con il specificato .

trailer. .ifexist
Questa opzione assume gli stessi valori di trailer.ifexist variabile di configurazione e
sovrascrive ciò che è specificato da quell'opzione per i rimorchi con il specificato .

trailer. .ifmissing
Questa opzione assume gli stessi valori di trailer.se manca variabile di configurazione e
sovrascrive ciò che è specificato da quell'opzione per i rimorchi con lo specificato .

trailer. .comando
Questa opzione può essere usata per specificare un comando di shell che sarà chiamato a
aggiungere o modificare automaticamente un trailer con lo specificato .

Quando questa opzione è specificata, il comportamento è come se fosse uno speciale =
argomento sono stati aggiunti all'inizio della riga di comando, dove è preso per essere
l'output standard del comando specificato con qualsiasi spazio bianco iniziale e finale
rifilato.

Se il comando contiene la stringa $ARG, questa stringa verrà sostituita con la
parte di un rimorchio esistente con lo stesso , se presente, prima che il comando sia
lanciato.

Se alcuni = gli argomenti vengono passati anche sulla riga di comando, quando a
trailer. .comando è configurato, il comando verrà eseguito anche per ciascuno di
questi argomenti. E il parte di questi argomenti, se presenti, verrà utilizzata per
sostituire la stringa $ARG nel comando.

ESEMPI

· Configura a segno rimorchio con a Firmato da chiave, quindi aggiungi due di questi trailer
a un messaggio:

$ git config trailer.sign.key "Firmato da"
$ gatto msg.txt
soggetto

messaggio
$ cat msg.txt | git interpret-trailers --trailer 'segno: Alice[email protected]>' --trailer 'segno: Bob[email protected]>'
soggetto

messaggio

Firmato da: Alice[email protected]>
Firmato da: Bob[email protected]>

· Estrai l'ultimo commit come patch e aggiungi a Cc e Recensito da trailer ad esso:

$ git formato-patch -1
0001-pippo.patch
$ git interpret-trailers --trailer 'Cc: Alice[email protected]>' --trailer 'Recensito da: Bob[email protected]>' 0001-pippo.patch >0001-bar.patch

· Configura a segno trailer con un comando per aggiungere automaticamente un 'Firmato da: ' con
le informazioni sull'autore solo se non c'è già un 'Firmato-off-by:' e mostra come
lavori:

$ git config trailer.sign.key "Firmato da: "
$ git config trailer.sign.ifmissing add
$ git config trailer.sign.ifexists non fa niente
$ git config trailer.sign.command 'echo "$(git config user.name) <$(git config user.email)>"'
$ git interpret-trailers <
> EOF

Firmato da: Bob[email protected]>
$ git interpret-trailers <
> Firmato da: Alice[email protected]>
> EOF

Firmato da: Alice[email protected]>

· Configura a fisso rimorchio con una chiave che contiene a # e nessuno spazio dopo questo
personaggio e mostra come funziona:

$ git config trailer.separators ":#"
$ git config trailer.fix.key "Fix #"
$ echo "soggetto" | git interpret-trailers --trailer fix=42
soggetto

Correggere #42

· Configura a vedere trailer con un comando per mostrare l'oggetto di un commit che è
correlati e mostra come funziona:

$ git config trailer.see.key "Vedi anche: "
$ git config trailer.see.ifExists "sostituisci"
$ git config trailer.see.ifMissing "doNothing"
$ git config trailer.see.command "git log -1 --oneline --format=\"%h (%s)\" --abbrev-commit --abbrev=14 \$ARG"
$ git interpret-trailers <
> soggetto
>
> messaggio
>
> vedi: TESTA~2
> EOF
soggetto

messaggio

Vedi anche: fe3187489d69c4 (oggetto del commit correlato)

· Configura un modello di commit con alcuni trailer con valori vuoti (usando sed per mostrare
e mantieni gli spazi finali alla fine dei trailer), quindi configura un commit-msg
gancio che usa git interpreti-trailer per rimuovere i trailer con valori vuoti e per aggiungere
a versione git trailer:

$ sed -e 's/ Z$/ /' >commit_template.txt <
> ***oggetto***
>
> ***messaggio***
>
> Correzioni: Z
> Cc: Z
> Recensito da: Z
> Firmato da: Z
> EOF
$ git config commit.template commit_template.txt
$ cat >.git/hooks/commit-msg <
> #!/bin/sh
> git interpret-trailers --trim-empty --trailer "git-version: \$(git descrivere)" "\$1" > "\$1.new"
> mv "\$1.nuovo" "\$1"
> EOF
$ chmod +x .git/hooks/commit-msg

Usa git-interpret-trailers online utilizzando i servizi onworks.net