git-interpret-trailer - Online sa Cloud

PROGRAMA:

NAME

git-interpret-trailer - tumulong na magdagdag ng structured na impormasyon sa mga commit na mensahe

SINOPSIS

pumunta interpreters-trailer [--trim-empty] [(--trailer [(=|:) ])...] [ ...]

DESCRIPTION

Tumulong sa pagdaragdag trailer mga linya, na kamukha ng RFC 822 e-mail header, sa dulo ng
kung hindi man ay malayang bahagi ng isang commit message.

Ang utos na ito ay nagbabasa ng ilang mga patch o gumawa ng mga mensahe mula sa alinman sa mga argumento o ang
karaniwang input kung hindi ay tinukoy. Pagkatapos ay inilalapat ng utos na ito ang mga argumentong naipasa
gamit ang --trailer na opsyon, kung mayroon man, sa commit message na bahagi ng bawat input file. Ang
resulta ay ibinubuga sa karaniwang output.

Kinokontrol ng ilang mga variable ng configuration ang paraan ng paglalapat ng --trailer argument sa bawat isa
commit message at ang paraan ng pagbabago ng anumang umiiral na trailer sa commit message. sila
gawin ding posible na awtomatikong magdagdag ng ilang trailer.

Bilang default, a = or : argument na ibinigay gamit ang --trailer ay magiging
idinagdag pagkatapos ng mga umiiral na trailer lamang kung ang huling trailer ay may iba ( ,
) pares (o kung walang umiiral na trailer). Ang at magiging bahagi
trimmed upang alisin ang panimulang at trailing na whitespace, at ang resulta ay pinutol at
lalabas sa mensaheng ganito:

token: halaga

Nangangahulugan ito na ang trimmed at ay paghihiwalayin ng ': ' (isang tutuldok
sinusundan ng isang puwang).

Bilang default, lalabas ang bagong trailer sa dulo ng lahat ng umiiral na trailer. Kung meron
ay walang umiiral na trailer, lalabas ang bagong trailer pagkatapos ng commit message na bahagi ng
output, at, kung walang linya na may mga puwang lamang sa dulo ng bahagi ng commit message,
isang blangkong linya ang idadagdag bago ang bagong trailer.

Ang mga kasalukuyang trailer ay kinukuha mula sa input message sa pamamagitan ng paghahanap ng grupo ng isa o
higit pang mga linya na naglalaman ng colon (bilang default), kung saan ang grupo ay nauuna ng isa o higit pa
walang laman (o whitespace-only) na mga linya. Ang grupo ay dapat na nasa dulo ng mensahe o nasa dulo
ang huling mga linyang hindi whitespace bago ang isang linya na nagsisimula sa ---. Ang gayong tatlong minus na palatandaan
simulan ang patch na bahagi ng mensahe.

Kapag nagbabasa ng mga trailer, maaaring may mga whitespace bago at pagkatapos ng token, ang separator
at ang halaga. Maaari ding mayroong mga whitespace sa loob ng token at ang halaga.

Tandaan na ang trailer huwag sundin at hindi nilayon na sundin ang maraming panuntunan para sa RFC 822
mga header. Halimbawa hindi nila sinusunod ang line folding rules, ang encoding rules at
marahil maraming iba pang mga patakaran.

Opsyon

--trim-empty
Kung ang bahagi ng anumang trailer ay naglalaman lamang ng whitespace, ang buong trailer ay magiging
inalis mula sa nagresultang mensahe. Nalalapat ito sa mga kasalukuyang trailer pati na rin sa bago
trailer.

--trailer [(=|:) ]
Tukuyin ang isang ( , ) pares na dapat ilapat bilang trailer sa input
mga mensahe. Tingnan ang paglalarawan ng utos na ito.

Configuration MGA VARIABLE

trailer.separators
Sinasabi ng opsyong ito kung aling mga character ang kinikilala bilang mga trailer separator. Bilang default
lamang : ay kinikilala bilang isang trailer separator, maliban doon = ay palaging tinatanggap sa
command line para sa pagiging tugma sa iba pang git command.

Ang unang character na ibinigay ng opsyong ito ay ang default na character na ginamit noong
isa pang separator ay hindi tinukoy sa config para sa trailer na ito.

Halimbawa, kung ang value para sa opsyong ito ay "%=$", kung gayon ang mga linya lamang na gumagamit ng format
kasama naglalaman ng %, = or $ at pagkatapos ay isasaalang-alang ang mga puwang
mga trailer. At % ay ang default na separator na ginamit, kaya sa pamamagitan ng default na mga trailer ay lilitaw
gaya ng: % (isang porsyentong tanda at isang puwang ang lalabas sa pagitan ng token
at ang halaga).

trailer.saan
Sinasabi ng opsyong ito kung saan magdadagdag ng bagong trailer.

Ito ay maaaring wakas, na siyang default, simula, pagkatapos o bago.

Kung ito ay tapos na, ang bawat bagong trailer ay lalabas sa dulo ng mga umiiral na trailer.

Kung ito ay simula, ang bawat bagong trailer ay lalabas sa simula, sa halip na sa dulo, ng
ang mga umiiral na trailer.

Kung pagkatapos nito, lalabas ang bawat bagong trailer pagkatapos lamang ng huling trailer na may
pareho .

Kung ito ay dati, ang bawat bagong trailer ay lilitaw bago ang unang trailer na may
pareho .

trailer.ifexists
Ginagawang posible ng opsyong ito na piliin kung anong aksyon ang isasagawa kapag mayroon
mayroon nang kahit isang trailer na may pareho sa mensahe.

Ang mga wastong halaga para sa opsyong ito ay: addIfDifferentNeighbor (ito ang default),
addIfDifferent, idagdag, i-overwrite o doNothing.

Sa addIfDifferentNeighbor, magdaragdag lang ng bagong trailer kung walang trailer na may
pareho ( , ) pares ay nasa itaas o ibaba ng linya kung saan ang bagong trailer
idinagdag.

Sa addIfDifferent, magdaragdag lang ng bagong trailer kung walang trailer na may pareho
( , ) pares ay nasa mensahe na.

Sa pagdaragdag, isang bagong trailer ang idadagdag, kahit na ang ilang mga trailer ay may parehong ( ,
) pares ay nasa mensahe na.

May kapalit, isang umiiral na trailer na may pareho tatanggalin at ang bago
idadagdag ang trailer. Ang tinanggal na trailer ang magiging pinakamalapit (na may pareho
) sa lugar kung saan idadagdag ang bago.

Sa doNothing, walang gagawin; na walang bagong trailer ang idadagdag kung meron
isa na sa pareho sa mensahe.

trailer.kung nawawala
Ginagawang posible ng opsyong ito na piliin kung anong aksyon ang isasagawa kapag mayroon
wala pang trailer na may pareho sa mensahe.

Ang mga wastong halaga para sa opsyong ito ay: idagdag (ito ang default) at doNothing.

Sa pagdaragdag, may idaragdag na bagong trailer.

Sa doNothing, walang gagawin.

trailer. .susi
Ang susi na ito ang gagamitin sa halip na sa trailer. Sa dulo ng susi na ito, a
maaaring lumitaw ang separator at pagkatapos ay ilang mga space character. Bilang default ang tanging wasto
ang separator ay :, ngunit ito ay maaaring baguhin gamit ang trailer.separators config variable.

Kung mayroong isang separator, ang susi ang gagamitin sa halip na pareho ang at ang
default na separator kapag nagdaragdag ng trailer.

trailer. .saan
Ang pagpipiliang ito ay tumatagal ng parehong mga halaga bilang ang trailer.saan configuration variable at ito
override kung ano ang tinukoy ng opsyon na iyon para sa mga trailer na may tinukoy .

trailer. .ifexist
Ang pagpipiliang ito ay tumatagal ng parehong mga halaga bilang ang trailer.ifexist configuration variable at ito
override kung ano ang tinukoy ng opsyon na iyon para sa mga trailer na may tinukoy .

trailer. .kung nawawala
Ang pagpipiliang ito ay tumatagal ng parehong mga halaga bilang ang trailer.kung nawawala variable ng pagsasaayos at
ni-override nito ang tinukoy ng opsyong iyon para sa mga trailer na may tinukoy .

trailer. .utos
Maaaring gamitin ang opsyong ito para tukuyin ang shell command na tatawagan
awtomatikong magdagdag o magbago ng trailer na may tinukoy .

Kapag tinukoy ang pagpipiliang ito, ang pag-uugali ay parang isang espesyal =
Ang argumento ay idinagdag sa simula ng command line, kung saan ay kinuha na
ang karaniwang output ng tinukoy na command na may anumang nangunguna at sumusunod na whitespace
pinutol.

Kung ang command ay naglalaman ng $ARG string, ang string na ito ay papalitan ng
bahagi ng isang umiiral na trailer na may pareho , kung mayroon man, bago ang utos ay
inilunsad.

Kung ilan = Ang mga argumento ay ipinapasa din sa command line, kapag a
trailer. .utos ay naka-configure, ang command ay isasagawa din para sa bawat isa
ang mga argumentong ito. At ang bahagi ng mga argumentong ito, kung mayroon man, ay gagamitin
palitan ang $ARG string sa command.

HALIMBAWA

· I-configure ang a mag-sign trailer na may a Ni-sign-off-by key, at pagkatapos ay magdagdag ng dalawa sa mga trailer na ito
sa isang mensahe:

$ git config trailer.sign.key "Na-sign-off-by"
$ cat msg.txt
paksa

mensahe
$ cat msg.txt | git interpret-trailer --trailer 'sign: Alice[protektado ng email]>' --trailer 'sign: Bob[protektado ng email]>'
paksa

mensahe

Pinirmahan-off-ni: Alice[protektado ng email]>
Pinirmahan-off-ni: Bob[protektado ng email]>

· I-extract ang huling commit bilang isang patch, at magdagdag ng a Cc at Sinuri-ni trailer nito:

$ git format-patch -1
0001-foo.patch
$ git interpret-trailer --trailer 'Cc: Alice[protektado ng email]>' --trailer 'Sinuri-ni: Bob[protektado ng email]>' 0001-foo.patch >0001-bar.patch

· I-configure ang a mag-sign trailer na may command na awtomatikong magdagdag ng 'Signed-off-by: ' na may
ang impormasyon ng may-akda lamang kung wala pang 'Signed-off-by: ', at ipakita kung paano ito
mga gawa:

$ git config trailer.sign.key "Na-sign-off-by: "
$ git config trailer.sign.ifmissing idagdag
$ git config trailer.sign.ifexists doNothing
$ git config trailer.sign.command 'echo "$(git config user.name) <$(git config user.email)>"'
$ git interpret-trailer <
> EOF

Pinirmahan-off-ni: Bob[protektado ng email]>
$ git interpret-trailer <
> Pinirmahan-off-ni: Alice[protektado ng email]>
> EOF

Pinirmahan-off-ni: Alice[protektado ng email]>

· I-configure ang a ayusin trailer na may susi na naglalaman ng a # at walang puwang pagkatapos nito
karakter, at ipakita kung paano ito gumagana:

$ git config trailer.separators ":#"
$ git config trailer.fix.key "Ayusin ang #"
$ echo "paksa" | git interpret-trailer --trailer fix=42
paksa

Ayusin ang #42

· I-configure ang a makita trailer na may isang command upang ipakita ang paksa ng isang commit na
nauugnay, at ipakita kung paano ito gumagana:

$ git config trailer.see.key "Tingnan-din: "
$ git config trailer.see.ifExists "palitan"
$ git config trailer.see.ifNawawala ang "doNothing"
$ git config trailer.see.command "git log -1 --oneline --format=\"%h (%s)\" --abbrev-commit --abbrev=14 \$ARG"
$ git interpret-trailer <
> paksa
>
> mensahe
>
> tingnan ang: ULO~2
> EOF
paksa

mensahe

Tingnan din ang: fe3187489d69c4 (paksa ng kaugnay na commit)

· Mag-configure ng commit template na may ilang trailer na may mga walang laman na value (gamit ang sed upang ipakita
at panatilihin ang mga trailing space sa dulo ng mga trailer), pagkatapos ay i-configure ang isang commit-msg
hook na gumagamit pumunta interpreters-trailer upang alisin ang mga trailer na may mga walang laman na halaga at magdagdag
a git-bersyon trailer:

$ sed -e 's/ Z$/ /' >commit_template.txt <
> ***paksa***
>
> ***mensahe***
>
> Mga Pag-aayos: Z
> Cc: Z
> Sinuri-ni: Z
> Ni-sign-off-ni: Z
> EOF
$ git config commit.template commit_template.txt
$ cat >.git/hooks/commit-msg <
> #!/ Bin / SH
> git interpret-trailer --trim-empty --trailer "git-version: \$(git describe)" "\$1" > "\$1.new"
> mv "\$1.bago" "\$1"
> EOF
$ chmod +x .git/hooks/commit-msg

Gumamit ng git-interpret-trailer online gamit ang mga serbisyo ng onworks.net