git-interpret-trailers - Online in de cloud

PROGRAMMA:

NAAM

git-interpret-trailers - help bij het toevoegen van gestructureerde informatie aan commit-berichten

KORTE INHOUD

git interpreteren-trailers [--trim-leeg] [(--trailer [(=|:) ])...] [ ...]

PRODUCTBESCHRIJVING

Hulp bij toevoegen aanhangwagens regels, die lijken op RFC 822 e-mailheaders, aan het einde van de
anders een vrij deel van een commit-bericht.

Deze opdracht leest enkele patches of commit-berichten van ofwel de argumenten of de
standaard invoer indien nee is gespecificeerd. Vervolgens past dit commando de doorgegeven argumenten toe
gebruik de optie --trailer, indien aanwezig, voor het commit-berichtgedeelte van elk invoerbestand. De
resultaat wordt uitgezonden op de standaarduitvoer.

Sommige configuratievariabelen bepalen de manier waarop de argumenten --trailer op elk worden toegepast
commit-bericht en de manier waarop elke bestaande trailer in het commit-bericht wordt gewijzigd. Zij
maken het ook mogelijk om automatisch enkele aanhangers toe te voegen.

Standaard een = or : argument gegeven met behulp van --trailer zal zijn
alleen toegevoegd na de bestaande trailers als de laatste trailer een andere ( ,
) paar (of als er geen bestaande trailer is). De En delen zullen zijn
getrimd om beginnende en afsluitende witruimte te verwijderen, en het resulterende getrimd En
verschijnt als volgt in het bericht:

teken: waarde

Dit betekent dat de getrimd En wordt gescheiden door ':' (één dubbele punt
gevolgd door een spatie).

Standaard verschijnt de nieuwe trailer aan het einde van alle bestaande trailers. Als er
geen bestaande trailer is, zal de nieuwe trailer verschijnen na het commit-berichtgedeelte van de
uitvoer, en als er geen regel is met alleen spaties aan het einde van het commit-berichtgedeelte,
er wordt een lege regel toegevoegd vóór de nieuwe trailer.

Bestaande trailers worden uit het invoerbericht gehaald door te zoeken naar een groep van één of
meer regels die een dubbele punt bevatten (standaard), waarbij de groep wordt voorafgegaan door een of meer
lege (of alleen witruimte) regels. De groep moet aan het einde van het bericht staan ​​of zijn
de laatste regels zonder witruimte voor een regel die begint met ---. Zulke drie mintekens
start het patchgedeelte van het bericht.

Bij het lezen van trailers kunnen er spaties voor en na het token, het scheidingsteken, staan
en de waarde. Er kunnen ook spaties zijn in het token en de waarde.

Merk op dat aanhangwagens volgen niet veel regels voor RFC 822 en zijn niet bedoeld om deze te volgen
koppen. Ze houden zich bijvoorbeeld niet aan de regelvouwregels, de coderingsregels en
waarschijnlijk vele andere regels.

OPTIES

--trim-leeg
Als de een deel van een trailer bevat alleen witruimte, de hele trailer zal dat zijn
verwijderd uit het resulterende bericht. Dit geldt zowel voor bestaande trailers als voor nieuwe
trailers.

-- aanhangwagen [(=|:) ]
Geef een ( , ) paar dat als een aanhangwagen op de ingang moet worden toegepast
berichten. Zie de beschrijving van deze opdracht.

CONFIGURATIE VARIABELEN

aanhangwagen.scheiders
Deze optie geeft aan welke tekens worden herkend als scheidingstekens voor opleggers. Standaard
Slechts : wordt erkend als aanhangerscheider, behalve dat = wordt altijd geaccepteerd op de
opdrachtregel voor compatibiliteit met andere git-opdrachten.

Het eerste teken dat door deze optie wordt gegeven, is het standaardteken dat wordt gebruikt wanneer
een ander scheidingsteken is niet gespecificeerd in de configuratie voor deze trailer.

Als de waarde voor deze optie bijvoorbeeld "%=$" is, dan gebruiken alleen regels het formaat
met bevatten %, = or $ en dan zullen spaties worden overwogen
aanhangwagens. En % zal het standaard gebruikte scheidingsteken zijn, dus standaard zullen trailers verschijnen
graag willen: % (een procentteken en een spatie verschijnen tussen het token
en de waarde).

aanhangwagen.waar
Deze optie vertelt waar een nieuwe trailer zal worden toegevoegd.

Dit kan end zijn, wat standaard is, start, after of before.

Als het einde is, verschijnt elke nieuwe trailer aan het einde van de bestaande trailers.

Als het begin is, verschijnt elke nieuwe trailer aan het begin in plaats van aan het einde van
de bestaande aanhangwagens.

Als het erna is, verschijnt elke nieuwe trailer net na de laatste trailer met de
dezelfde .

Als het eerder is, verschijnt elke nieuwe trailer net voor de eerste trailer met
hetzelfde .

trailer.if bestaat
Deze optie maakt het mogelijk om te kiezen welke actie er op dat moment wordt uitgevoerd
al minstens één trailer met hetzelfde in het bericht.

De geldige waarden voor deze optie zijn: addIfDifferentNeighbor (dit is de standaard),
addIfDifferent, toevoegen, overschrijven of niets doen.

Met addIfDifferentNeighbor wordt alleen een nieuwe trailer toegevoegd als er geen trailer bij is
dezelfde ( , ) paar is boven of onder de lijn waar de nieuwe trailer zal zijn
toegevoegd.

Met addIfDifferent wordt alleen een nieuwe trailer toegevoegd als er geen trailer met dezelfde is
( , ) paar staat al in het bericht.

Met toevoegen wordt een nieuwe trailer toegevoegd, ook al zijn er trailers met dezelfde ( ,
) paar staan ​​al in het bericht.

Met vervangen, een bestaande aanhangwagen met dezelfde wordt verwijderd en het nieuwe
aanhangwagen wordt toegevoegd. De verwijderde trailer is de dichtstbijzijnde (met dezelfde
) naar de plaats waar de nieuwe zal worden toegevoegd.

Met doNothing wordt er niets gedaan; dat wil zeggen dat er geen nieuwe trailer wordt toegevoegd als die er is
al een met hetzelfde in het bericht.

aanhangwagen.indien ontbreekt
Deze optie maakt het mogelijk om te kiezen welke actie er op dat moment wordt uitgevoerd
nog geen trailer met hetzelfde in het bericht.

De geldige waarden voor deze optie zijn: toevoegen (dit is de standaardinstelling) en niets doen.

Met toevoegen wordt er een nieuwe trailer toegevoegd.

Met doNothing wordt er niets gedaan.

aanhangwagen. .sleutel
Deze sleutel wordt gebruikt in plaats van in de aanhangwagen. Aan het einde van deze sleutel, a
scheidingsteken kan verschijnen en vervolgens enkele spatietekens. Standaard de enige geldige
scheidingsteken is :, maar dit kan worden gewijzigd met behulp van de configuratievariabele trailer.separators.

Als er een scheidingsteken is, wordt de sleutel gebruikt in plaats van zowel de en de
standaardscheidingsteken bij het toevoegen van de aanhangwagen.

aanhangwagen. .waar
Deze optie heeft dezelfde waarden als de aanhangwagen.waar configuratievariabele en it
overschrijft wat door die optie wordt gespecificeerd voor aanhangwagens met de opgegeven .

aanhangwagen. .ifexist
Deze optie heeft dezelfde waarden als de trailer.ifexist configuratievariabele en it
overschrijft wat door die optie wordt gespecificeerd voor aanhangwagens met de opgegeven .

aanhangwagen. .indien ontbreekt
Deze optie heeft dezelfde waarden als de aanhangwagen.indien ontbreekt configuratievariabele en
het overschrijft wat door die optie is gespecificeerd voor aanhangwagens met de opgegeven .

aanhangwagen. .commando
Deze optie kan worden gebruikt om een ​​shell-commando te specificeren waarnaar zal worden aangeroepen
automatisch een aanhanger toevoegen of wijzigen met de opgegeven .

Als deze optie is opgegeven, is het gedrag alsof het speciaal is =
argument toegevoegd aan het begin van de opdrachtregel, waar wordt aangenomen
de standaarduitvoer van de opgegeven opdracht met eventuele voorafgaande en afsluitende witruimte
afgeschoren.

Als de opdracht de tekenreeks $ARG bevat, wordt deze tekenreeks vervangen door de
onderdeel van een bestaande aanhangwagen met hetzelfde , indien van toepassing, voordat de opdracht is
gelanceerd.

Als iets = argumenten worden ook doorgegeven op de opdrachtregel, wanneer a
aanhangwagen. .commando is geconfigureerd, wordt de opdracht ook uitgevoerd voor elk van
deze argumenten. En de een deel van deze argumenten, indien aanwezig, zal worden gebruikt
vervang de $ARG-tekenreeks in de opdracht.

Voorbeelden

· Configureer een teken aanhanger met een Afgetekend door toets en voeg vervolgens twee van deze aanhangwagens toe
naar een bericht:

$ git config trailer.sign.key "Afgetekend door"
$ kat msg.txt
onderwerpen

Bericht
$ kat msg.txt | git interpret-trailers --trailer 'teken: Alice[e-mail beveiligd]>' --trailer 'teken: Bob[e-mail beveiligd]>'
onderwerpen

Bericht

Afgetekend door: Alice[e-mail beveiligd]>
Afgetekend door: Bob[e-mail beveiligd]>

· Extraheer de laatste commit als een patch en voeg een Cc en Beoordeeld door aanhangwagen erbij:

$ git formaat-patch -1
0001-foo.patch
$ git interpret-trailers --trailer 'Cc: Alice[e-mail beveiligd]>' --trailer 'Beoordeeld door: Bob[e-mail beveiligd]>' 0001-foo.patch >0001-bar.patch

· Configureer een teken trailer met een opdracht om automatisch een 'Afgetekend door:' mee toe te voegen
de auteursinformatie alleen als er nog geen 'Signed-off-by:' staat, en laat zien hoe
werken:

$ git config trailer.sign.key "Afgetekend door: "
$ git config trailer.sign.ifmissing toevoegen
$ git config trailer.sign.ifexists doet niets
$ git config trailer.sign.command 'echo "$(git config gebruiker.naam) <$(git config gebruiker.email)>"'
$ git interpret-trailers <
> EOF

Afgetekend door: Bob[e-mail beveiligd]>
$ git interpret-trailers <
> Afgetekend door: Alice[e-mail beveiligd]>
> EOF

Afgetekend door: Alice[e-mail beveiligd]>

· Configureer een repareren aanhangwagen met een sleutel die een # en daarna geen spatie
karakter, en laat zien hoe het werkt:

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

Fix #42

· Configureer een zien trailer met een commando om het onderwerp van een commit te tonen
gerelateerd, en laat zien hoe het werkt:

$ git config trailer.see.key "Zie ook: "
$ git config trailer.see.ifExists "vervangen"
$ 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 <
> onderwerp
>
> bericht
>
> zie: HOOFD~2
> EOF
onderwerpen

Bericht

Zie ook: fe3187489d69c4 (onderwerp van gerelateerde commit)

· Configureer een commit-sjabloon met enkele trailers met lege waarden (gebruik sed om te laten zien
en houd de volgspaties aan het einde van de trailers), configureer dan een commit-bericht
haak die gebruikt git interpreteren-trailers om trailers met lege waarden te verwijderen en toe te voegen
a git-versie trailer:

$ sed -e 's/ Z$/ /' >commit_template.txt <
> ***onderwerp***
>
> ***bericht***
>
> Oplossingen: Z
> Cc: Z
> Beoordeeld door: Z
> Afgetekend door: Z
> EOF
$ git config commit.template commit_template.txt
$ kat >.git/hooks/commit-msg <
> #!/ Bin / sh
> git interpret-trailers --trim-empty --trailer "git-versie: \$(git description)" "\$1" > "\$1.new"
> mv "\$1.nieuw" "\$1"
> EOF
$ chmod +x .git/hooks/commit-msg

Gebruik git-interpret-trailers online met behulp van onworks.net-services