git-interpret-trailers - Online în cloud

PROGRAM:

NUME

git-interpret-trailers - ajută la adăugarea de informații structurate în mesajele de confirmare

REZUMAT

merge interpret-remorci [--trim-empty] [(--remorcă [(=|:) ])...] [ ...]

DESCRIERE

Ajutor la adăugare remorci linii, care arată similar cu anteturile de e-mail RFC 822, la sfârșitul
în caz contrar, o parte liberă a unui mesaj de confirmare.

Această comandă citește unele patch-uri sau trimite mesaje de la argumente sau cel
intrare standard dacă nu este specificat. Apoi această comandă aplică argumentele transmise
folosind opțiunea --trailer, dacă există, la partea cu mesajul de confirmare a fiecărui fișier de intrare. The
rezultatul este emis pe ieșirea standard.

Unele variabile de configurare controlează modul în care argumentele --trailer sunt aplicate fiecăreia
mesajul de confirmare și modul în care orice trailer existent în mesajul de confirmare este modificat. ei
de asemenea, face posibilă adăugarea automată a unor remorci.

În mod implicit, a = or : argumentul dat folosind --trailer va fi
atașat după remorcile existente numai dacă ultima remorcă are un alt ( ,
) pereche (sau dacă nu există nicio remorcă). The și piese vor fi
tăiat pentru a elimina spațiile albe de început și de sfârșit, iar rezultatul este tăiat și
va apărea în mesaj astfel:

token: valoare

Aceasta înseamnă că tăiate și va fi despărțit prin „:” (un două puncte
urmată de un spațiu).

Implicit, noul trailer va apărea la sfârșitul tuturor trailerelor existente. În cazul în care există
nu există un trailer existent, noul trailer va apărea după partea mesajului de confirmare a mesajului
ieșire și, dacă nu există nicio linie cu doar spații la sfârșitul părții mesajului de confirmare,
o linie goală va fi adăugată înainte de noul trailer.

Trailerele existente sunt extrase din mesajul de intrare căutând un grup de unul sau
mai multe linii care conțin două puncte (în mod implicit), unde grupul este precedat de unul sau mai multe
linii goale (sau doar spații albe). Grupul trebuie fie să fie la sfârșitul mesajului, fie să fie
ultimele linii fără spații albe înainte de o linie care începe cu ---. Astfel de trei semne minus
începeți partea de corecție a mesajului.

Când citiți trailere, pot exista spații albe înainte și după simbol, separator
si valoarea. Pot exista și spații albe în interiorul simbolului și al valorii.

Rețineți că remorci nu urmează și nu sunt destinate să urmeze multe reguli pentru RFC 822
antete. De exemplu, nu respectă regulile de pliere a liniilor, regulile de codificare și
probabil multe alte reguli.

OPŢIUNI

--trim-gol
Dacă o parte din orice trailer conține doar spații albe, întregul trailer va fi
eliminat din mesajul rezultat. Acest lucru se aplică atât remorcilor existente, cât și celor noi
remorci.

--remorcă [(=|:) ]
Specificați un ( , ) pereche care ar trebui aplicată ca remorcă la intrare
mesaje. Vezi descrierea acestei comenzi.

CONFIGURARE VARIABILE

remorcă.separatoare
Această opțiune spune ce caractere sunt recunoscute ca separatoare de trailer. În mod implicit
afară : este recunoscut ca un separator de remorcă, cu excepția faptului că = este întotdeauna acceptată pe
linie de comandă pentru compatibilitate cu alte comenzi git.

Primul caracter dat de această opțiune va fi caracterul implicit folosit când
un alt separator nu este specificat în configurația pentru această remorcă.

De exemplu, dacă valoarea acestei opțiuni este „%=$”, atunci numai liniile care utilizează formatul
cu conținând %, = or $ iar apoi se vor lua în considerare spațiile
remorci. Și % va fi separatorul implicit folosit, așa că în mod implicit vor apărea remorci
ca: % (semnul unu la sută și un spațiu vor apărea între simbol
și valoarea).

remorcă.unde
Această opțiune spune unde va fi adăugată o nouă remorcă.

Acesta poate fi sfârşitul, care este implicit, începutul, după sau înainte.

Dacă se termină, atunci fiecare trailer nouă va apărea la sfârșitul trailerelor existente.

Dacă este începutul, atunci fiecare trailer nouă va apărea la începutul, nu la sfârșitul
remorcile existente.

Dacă este după, atunci fiecare trailer nouă va apărea imediat după ultimul trailer cu
la fel .

Dacă este înainte, atunci fiecare trailer nou va apărea chiar înainte de primul trailer cu
la fel .

remorcă.dacă există
Această opțiune face posibilă alegerea acțiunii care va fi efectuată atunci când există
deja cel puțin o remorcă cu aceeași în mesaj.

Valorile valide pentru această opțiune sunt: ​​addIfDifferentNeighbor (acesta este implicit),
addIfDifferent, adăugați, suprascrieți sau doNothing.

Cu addIfDifferentNeighbor, o nouă remorcă va fi adăugată numai dacă nu există nicio remorcă cu
la fel ( , ) perechea este deasupra sau sub linia unde va fi noua remorcă
adăugat.

Cu addIfDifferent, o nouă remorcă va fi adăugată numai dacă nu există nicio remorcă cu aceeași
( , ) perechea este deja în mesaj.

Cu add, o nouă remorcă va fi adăugată, chiar dacă unele trailere cu același ( ,
) perechea sunt deja în mesaj.

Cu înlocuire, o remorcă existentă cu aceeași vor fi șterse și cele noi
remorca va fi adăugată. Trailerul șters va fi cel mai apropiat (cu același
) la locul unde va fi adăugat cel nou.

Cu doNothing, nu se va face nimic; aceasta este nicio remorcă nouă nu va fi adăugată dacă există
deja unul cu acelasi în mesaj.

remorcă.dacă lipsește
Această opțiune face posibilă alegerea acțiunii care va fi efectuată atunci când există
nu încă nicio remorcă cu aceeași în mesaj.

Valorile valide pentru această opțiune sunt: ​​add (aceasta este implicit) și doNothing.

Cu add, va fi adăugată o nouă trailer.

Cu doNothing, nu se va face nimic.

remorcă. .cheie
Această cheie va fi folosită în loc de în remorcă. La sfârșitul acestei chei, a
pot apărea separator și apoi unele caractere de spațiu. Implicit singurul valid
separatorul este :, dar acest lucru poate fi modificat folosind variabila de configurare trailer.separators.

Dacă există un separator, atunci cheia va fi folosită în locul ambelor si
separator implicit la adăugarea remorcii.

remorcă. .Unde
Această opțiune are aceleași valori ca și remorcă.unde variabila de configurare și aceasta
suprascrie ceea ce este specificat de acea opțiune pentru remorci cu specificația .

remorcă. .dacă există
Această opțiune are aceleași valori ca și remorcă.dacă există variabila de configurare și aceasta
suprascrie ceea ce este specificat de acea opțiune pentru remorci cu specificația .

remorcă. .dacă lipsesc
Această opțiune are aceleași valori ca și remorcă.dacă lipsește variabila de configurare si
suprascrie ceea ce este specificat de acea opțiune pentru remorci cu specificația .

remorcă. .comanda
Această opțiune poate fi folosită pentru a specifica o comandă shell la care va fi apelată
adăugați sau modificați automat o remorcă cu cele specificate .

Când este specificată această opțiune, comportamentul este ca și cum unul special =
argument au fost adăugate la începutul liniei de comandă, unde este considerat a fi
ieșirea standard a comenzii specificate cu orice spațiu alb de început și de final
decupat.

Dacă comanda conține șirul $ARG, acest șir va fi înlocuit cu șirul
parte dintr-o remorcă existentă cu aceeași , dacă există, înainte ca comanda să fie
lansat.

Dacă unii = argumentele sunt transmise și pe linia de comandă, când a
remorcă. .comanda este configurat, comanda va fi executată și pentru fiecare dintre
aceste argumente. Si o parte din aceste argumente, dacă există, va fi folosită
înlocuiți șirul $ARG din comandă.

EXEMPLE

· Configurați a semna remorcă cu a Semnat de către cheie, apoi adăugați două dintre aceste remorci
la un mesaj:

$ git config trailer.sign.key „Signat de”
$ cat msg.txt
subiect

mesaj
$ cat msg.txt | git interpret-trailers --trailer 'sign: Alice[e-mail protejat]>' --remorcă 'semn: Bob[e-mail protejat]>'
subiect

mesaj

Semnat de: Alice[e-mail protejat]>
Semnat de: Bob[e-mail protejat]>

· Extrageți ultimul comit ca patch și adăugați a Cc și Revizuite de trailer la el:

$ git format-patch -1
0001-foo.patch
$ git interpret-trailers --trailer 'Cc: Alice[e-mail protejat]>' --trailer 'Revizuit-de: Bob[e-mail protejat]>' 0001-foo.patch >0001-bar.patch

· Configurați a semna remorcă cu o comandă pentru a adăuga automat un „Signed-by:” cu
informațiile despre autor numai dacă nu există deja „Sign-off-by:” și arată cum se face
lucrări:

$ git config trailer.sign.key „Semnat de: „
$ git config trailer.sign.ifmissing add
$ git config trailer.sign.ifexists doNothing
$ git config trailer.sign.command „echo „$(git config user.name) <$(git config user.email)>””
$ git interpret-trailers <
> EOF

Semnat de: Bob[e-mail protejat]>
$ git interpret-trailers <
> Semnat de: Alice[e-mail protejat]>
> EOF

Semnat de: Alice[e-mail protejat]>

· Configurați a stabili remorcă cu o cheie care conține a # și fără spațiu după asta
caracter și arată cum funcționează:

$ git config trailer.separators „:#”
$ git config trailer.fix.key „Remediere #”
$ echo „subiect” | git interpret-trailers --trailer fix=42
subiect

Fix # 42

· Configurați a vedea remorcă cu o comandă pentru a arăta subiectul unui commit care este
legate și arată cum funcționează:

$ git config trailer.see.key "Vezi și: "
$ git config trailer.see.ifExists „înlocuiește”
$ git config trailer.see.ifLipsește „doNothing”
$ git config trailer.see.command "git log -1 --oneline --format=\"%h (%s)\" --abbrev-commit --abbrev=14 \$ARG"
$ git interpret-trailers <
> subiect
>
> mesaj
>
> vezi: CAP~2
> EOF
subiect

mesaj

Vedeți și: fe3187489d69c4 (subiectul comiterii aferente)

· Configurați un șablon de confirmare cu unele trailere cu valori goale (folosind sed pentru a afișa
și păstrați spațiile de sfârșit de la sfârșitul trailerelor), apoi configurați un commit-msg
cârlig care folosește merge interpret-remorci pentru a elimina remorci cu valori goale și pentru a adăuga
a versiunea git trailer:

$ sed -e 's/ Z$/ /' >commit_template.txt <
> ***subiect***
>
> ***mesaj***
>
> Remedieri: Z
> Cc: Z
> Examinat de: Z
> Semnat de: 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 describe)" "\$1" > "\$1.new"
> mv „\$1.new” „\$1”
> EOF
$ chmod +x .git/hooks/commit-msg

Utilizați git-interpret-trailers online folosind serviciile onworks.net