git-interpret-trailers - ออนไลน์ใน Cloud

โครงการ:

ชื่อ

git-interpret-trailers - ช่วยเพิ่มข้อมูลที่มีโครงสร้างลงในข้อความคอมมิต

เรื่องย่อ

คอมไพล์ ล่ามรถพ่วง [--ตัด-ว่างเปล่า] [(--รถพ่วง [(=|:) ])...] [ ...]

DESCRIPTION

ช่วยเพิ่ม รถพ่วง บรรทัดที่คล้ายกับส่วนหัวของอีเมล RFC 822 ที่ส่วนท้ายของ
มิฉะนั้น ส่วนรูปแบบอิสระของข้อความยืนยัน

คำสั่งนี้อ่านแพตช์หรือคอมมิตข้อความจาก ข้อโต้แย้งหรือ
อินพุตมาตรฐานถ้าไม่มี ระบุไว้ จากนั้นคำสั่งนี้จะใช้อาร์กิวเมนต์ที่ส่งผ่าน
ใช้ตัวเลือก --trailer หากมี ไปยังส่วนข้อความยืนยันของแต่ละไฟล์อินพุต NS
ผลลัพธ์จะถูกปล่อยออกมาบนเอาต์พุตมาตรฐาน

ตัวแปรการกำหนดค่าบางตัวควบคุมวิธีการใช้อาร์กิวเมนต์ --trailer กับแต่ละ
คอมมิตข้อความและวิธีเปลี่ยนตัวอย่างที่มีอยู่ในข้อความคอมมิต พวกเขา
ยังทำให้สามารถเพิ่มตัวอย่างบางส่วนได้โดยอัตโนมัติ

โดยค่าเริ่มต้น a = or : อาร์กิวเมนต์ที่กำหนดโดยใช้ --trailer จะเป็น
ต่อท้ายตัวอย่างที่มีอยู่ก็ต่อเมื่อตัวอย่างสุดท้ายมีความแตกต่างกัน ( ,
) คู่ (หรือหากไม่มีตัวอย่าง) NS และ ส่วนจะเป็น
ตัดแต่งเพื่อลบช่องว่างเริ่มต้นและต่อท้าย และผลลัพธ์ที่ถูกตัดแต่ง และ
จะปรากฏในข้อความดังนี้

โทเค็น: ค่า

แปลว่า ตัดแต่งแล้ว และ จะถูกคั่นด้วย ': ' (หนึ่งโคลอน
ตามด้วยหนึ่งช่องว่าง)

โดยค่าเริ่มต้น ตัวอย่างใหม่จะปรากฏที่ส่วนท้ายของตัวอย่างที่มีอยู่ทั้งหมด ถ้ามี
ไม่ใช่ตัวอย่างที่มีอยู่ ตัวอย่างใหม่จะปรากฏขึ้นหลังจากส่วนข้อความยืนยันของ
เอาต์พุต และหากไม่มีบรรทัดที่มีช่องว่างเพียงส่วนท้ายของส่วนข้อความยืนยัน
จะมีการเพิ่มบรรทัดว่างก่อนตัวอย่างใหม่

ตัวอย่างที่มีอยู่จะถูกดึงออกมาจากข้อความอินพุตโดยมองหากลุ่มหนึ่งหรือ
หลายบรรทัดที่มีเครื่องหมายทวิภาค (โดยค่าเริ่มต้น) โดยที่กลุ่มนำหน้าด้วยอย่างน้อยหนึ่งรายการ
บรรทัดว่าง (หรือช่องว่างเท่านั้น) กลุ่มต้องอยู่ท้ายข้อความหรือ be
บรรทัดสุดท้ายที่ไม่ใช่ช่องว่างก่อนบรรทัดที่ขึ้นต้นด้วย ---. เครื่องหมายลบสามตัวดังกล่าว
เริ่มส่วนแก้ไขของข้อความ

เมื่ออ่านตัวอย่างอาจมีช่องว่างก่อนและหลังโทเค็นตัวคั่น
และค่า นอกจากนี้ยังสามารถมีช่องว่างภายในโทเค็นและค่าได้อีกด้วย

โปรดทราบว่า รถพ่วง ไม่ปฏิบัติตามและไม่ได้ตั้งใจที่จะปฏิบัติตามกฎหลายข้อสำหรับ RFC 822
ส่วนหัว ตัวอย่างเช่น ไม่ปฏิบัติตามกฎการพับบรรทัด กฎการเข้ารหัส และ
อาจเป็นกฎอื่น ๆ อีกมากมาย

OPTIONS

--ตัด-ว่างเปล่า
ถ้า ส่วนหนึ่งของตัวอย่างใด ๆ มีเพียงช่องว่าง รถพ่วงทั้งหมดจะเป็น
ออกจากข้อความผลลัพธ์ สิ่งนี้ใช้กับรถพ่วงที่มีอยู่และใหม่
รถพ่วง

--รถพ่วง [(=|:) ]
ระบุ ( , ) คู่ที่ควรใช้เป็นตัวอย่างในการป้อนข้อมูล
ข้อความ ดูคำอธิบายของคำสั่งนี้

การกำหนดค่า ตัวแปร

รถพ่วง.คั่น
ตัวเลือกนี้บอกว่าอักขระใดที่รู้จักเป็นตัวคั่นตัวอย่าง โดยค่าเริ่มต้น
เพียง : ถือเป็นเครื่องแยกส่วนพ่วง เว้นแต่ = เป็นที่ยอมรับเสมอใน
บรรทัดคำสั่งสำหรับความเข้ากันได้กับคำสั่ง git อื่น ๆ

อักขระตัวแรกที่กำหนดโดยตัวเลือกนี้จะเป็นอักขระเริ่มต้นที่ใช้เมื่อ
ไม่ได้ระบุตัวคั่นอื่นในการกำหนดค่าสำหรับตัวอย่างนี้

ตัวอย่างเช่น หากค่าสำหรับตัวเลือกนี้คือ "%=$" ให้แสดงเฉพาะบรรทัดที่ใช้รูปแบบ
กับ ประกอบด้วย %, = or $ แล้วช่องว่างจะถูกพิจารณา
รถพ่วง และ % จะเป็นตัวคั่นเริ่มต้นที่ใช้ดังนั้นโดยค่าเริ่มต้นตัวอย่างจะปรากฏขึ้น
ชอบ: % (เครื่องหมายร้อยละหนึ่งและช่องว่างหนึ่งจะปรากฏขึ้นระหว่างโทเค็น
และค่า)

รถพ่วง.ที่ไหน
ตัวเลือกนี้บอกตำแหน่งที่จะเพิ่มตัวอย่างใหม่

นี่อาจเป็นจุดสิ้นสุด ซึ่งเป็นค่าเริ่มต้น เริ่ม หลังหรือก่อน

หากจบลงแล้ว ตัวอย่างใหม่แต่ละรายการจะปรากฏที่ส่วนท้ายของตัวอย่างที่มีอยู่

หากเป็นจุดเริ่มต้น ตัวอย่างใหม่แต่ละรายการจะปรากฏที่จุดเริ่มต้นแทนที่จะเป็นจุดสิ้นสุดของ
รถพ่วงที่มีอยู่

หากเป็นหลังจากนั้น ตัวอย่างใหม่แต่ละรายการจะปรากฏต่อจากตัวอย่างสุดท้ายที่มีเครื่องหมาย
เหมือนกัน .

หากเป็นก่อนหน้านี้ ตัวอย่างใหม่แต่ละรายการจะปรากฏก่อนตัวอย่างแรกด้วย
เหมือน .

รถพ่วง.ifexists
ตัวเลือกนี้ทำให้สามารถเลือกการกระทำที่จะดำเนินการเมื่อมี
อย่างน้อยหนึ่งตัวอย่างที่มีเหมือนกัน ในข้อความ

ค่าที่ถูกต้องสำหรับตัวเลือกนี้คือ: addIfDifferentNeighbor (นี่คือค่าเริ่มต้น),
addIfDifferent เพิ่ม เขียนทับ หรือไม่ทำอะไรเลย

ด้วย addIfDifferentNeighbor ตัวอย่างใหม่จะถูกเพิ่มก็ต่อเมื่อไม่มีตัวอย่างที่มี
เหมือนกัน ( , ) คู่อยู่ด้านบนหรือด้านล่างบรรทัดที่ตัวอย่างใหม่จะเป็น
ที่เพิ่ม

ด้วย addIfDifferent ตัวอย่างใหม่จะถูกเพิ่มก็ต่อเมื่อไม่มีตัวอย่างที่เหมือนกัน
( , ) มีคู่อยู่ในข้อความแล้ว

ด้วยการเพิ่ม ตัวอย่างใหม่จะถูกเพิ่มแม้ว่าบางตัวอย่างจะเหมือนกัน ( ,
) มีคู่อยู่ในข้อความแล้ว

ด้วยการเปลี่ยนรถพ่วงที่มีอยู่เดิม จะถูกลบและใหม่
รถพ่วงจะถูกเพิ่ม ตัวอย่างที่ถูกลบจะใกล้เคียงที่สุด (เหมือนกัน
) ไปยังตำแหน่งที่จะเพิ่มรายการใหม่

ไม่มีอะไรจะทำ ที่ไม่มีตัวอย่างใหม่จะถูกเพิ่มถ้ามี
เป็นอันหนึ่งอันเดียวกันแล้ว ในข้อความ

รถพ่วง.ifmissing
ตัวเลือกนี้ทำให้สามารถเลือกการกระทำที่จะดำเนินการเมื่อมี
ยังไม่มีตัวอย่างที่เหมือนกัน ในข้อความ

ค่าที่ถูกต้องสำหรับตัวเลือกนี้คือ: เพิ่ม (นี่เป็นค่าเริ่มต้น) และไม่ทำอะไรเลย

ด้วยการเพิ่ม จะมีการเพิ่มตัวอย่างใหม่

ด้วย doNothing ไม่มีอะไรจะทำ

รถพ่วง .กุญแจ
คีย์นี้จะถูกใช้แทน ในรถพ่วง ในตอนท้ายของคีย์นี้ a
ตัวคั่นสามารถปรากฏขึ้นแล้วตามด้วยอักขระเว้นวรรคบางตัว โดยค่าเริ่มต้น valid . เท่านั้น
ตัวคั่นคือ :แต่สามารถเปลี่ยนแปลงได้โดยใช้ตัวแปรการกำหนดค่า trailer.separators

หากมีตัวคั่น ก็จะใช้คีย์แทนตัว และ
ตัวคั่นเริ่มต้นเมื่อเพิ่มตัวอย่าง

รถพ่วง .ที่ไหน
ตัวเลือกนี้ใช้ค่าเดียวกับ รถพ่วง.ที่ไหน ตัวแปรการกำหนดค่าและมัน
แทนที่สิ่งที่ระบุโดยตัวเลือกนั้นสำหรับรถพ่วงที่มีการระบุ .

รถพ่วง .ifexist
ตัวเลือกนี้ใช้ค่าเดียวกับ Trailer.ifexist ตัวแปรการกำหนดค่าและมัน
แทนที่สิ่งที่ระบุโดยตัวเลือกนั้นสำหรับรถพ่วงที่มีการระบุ .

รถพ่วง .ifmissing
ตัวเลือกนี้ใช้ค่าเดียวกับ รถพ่วง.ifmissing ตัวแปรการกำหนดค่าและ
มันแทนที่สิ่งที่ระบุโดยตัวเลือกนั้นสำหรับรถพ่วงที่มีการระบุ .

รถพ่วง .สั่งการ
สามารถใช้ตัวเลือกนี้เพื่อระบุคำสั่งเชลล์ที่จะเรียกใช้to
เพิ่มหรือแก้ไขตัวอย่างโดยอัตโนมัติตามที่ระบุ .

เมื่อระบุตัวเลือกนี้ ลักษณะการทำงานจะเหมือนกับพิเศษ =
เพิ่มอาร์กิวเมนต์ที่จุดเริ่มต้นของบรรทัดคำสั่งโดยที่ ถูกนำไปเป็น
เอาต์พุตมาตรฐานของคำสั่งที่ระบุพร้อมช่องว่างนำหน้าและต่อท้าย
ตัดออก

หากคำสั่งมีสตริง $ARG สตริงนี้จะถูกแทนที่ด้วย
ส่วนหนึ่งของรถพ่วงที่มีอยู่เดิมด้วย , ถ้ามี ก่อนคำสั่งคือ
เปิดตัว

ถ้ามีบ้าง = อาร์กิวเมนต์จะถูกส่งต่อบนบรรทัดคำสั่งเมื่อa
รถพ่วง .สั่งการ ได้รับการกำหนดค่าแล้ว คำสั่งจะถูกดำเนินการสำหรับแต่ละ
ข้อโต้แย้งเหล่านี้ และ ส่วนหนึ่งของข้อโต้แย้งเหล่านี้ หากมี จะถูกใช้เพื่อ
แทนที่สตริง $ARG ในคำสั่ง

ตัวอย่าง

· กำหนดค่า a ลงชื่อ รถพ่วงกับ ลงชื่อออกโดย คีย์ แล้วเพิ่มตัวอย่างสองตัวนี้
ไปที่ข้อความ:

$ git config trailer.sign.key "ลงชื่อออกโดย"
$ cat msg.txt
หรือ

ข่าวสาร
$ cat msg.txt | git interpret-trailers --trailer 'สัญลักษณ์: Alice[ป้องกันอีเมล]>' -- ป้ายรถพ่วง ': Bob[ป้องกันอีเมล]>'
หรือ

ข่าวสาร

ลงชื่อออกโดย: Alice[ป้องกันอีเมล]>
ลงชื่อออกโดย: Bob[ป้องกันอีเมล]>

· แยกการคอมมิตล่าสุดเป็นแพตช์ และเพิ่ม a Cc และ รีวิวโดย รถพ่วงไป:

$ git รูปแบบแพทช์ -1
0001-foo.patch
$ git interpret-trailers --trailer 'สำเนา: Alice[ป้องกันอีเมล]>' --trailer 'บทวิจารณ์โดย: Bob[ป้องกันอีเมล]>' 0001-foo.patch >0001-bar.patch

· กำหนดค่า a ลงชื่อ ตัวอย่างพร้อมคำสั่งให้เพิ่ม 'Signed-off-by: ' with . โดยอัตโนมัติ
ข้อมูลผู้เขียนก็ต่อเมื่อไม่มี 'Signed-off-by: ' อยู่แล้ว และแสดงว่าเป็นอย่างไร
ผลงาน:

$ git config trailer.sign.key "ลงชื่อออกโดย: "
$ git config trailer.sign.ifmissing เพิ่ม
$ git config trailer.sign.ifexists ไม่ทำอะไรเลย
$ git config trailer.sign.command 'echo "$(git config user.name) <$(git config user.email)>"'
$ git ล่ามตัวอย่าง <
> EOF

ลงชื่อออกโดย: Bob[ป้องกันอีเมล]>
$ git ล่ามตัวอย่าง <
> ลงชื่อออกโดย: Alice[ป้องกันอีเมล]>
> EOF

ลงชื่อออกโดย: Alice[ป้องกันอีเมล]>

· กำหนดค่า a แก้ไขปัญหา พ่วงด้วยคีย์ที่มี a # และไม่มีที่ว่างหลังจากนี้
และแสดงวิธีการทำงาน:

$ git config trailer.separators ":#"
$ git config trailer.fix.key "แก้ไข #"
$ echo "หัวเรื่อง" | git interpret-trailers --trailer fix=42
หรือ

แก้ไข # 42

· กำหนดค่า a เห็น trailer พร้อมคำสั่งแสดงหัวข้อของ commit ที่เป็น
ที่เกี่ยวข้องและแสดงวิธีการทำงาน:

$ git config trailer.see.key "ดูเพิ่มเติม:"
$ git config trailer.see.ifExists "แทนที่"
$ git config trailer.see.ifMissing "ไม่ทำอะไรเลย"
$ git config trailer.see.command "git log -1 --oneline --format=\"%h (%s)\" --abbrev-commit --abbrev=14 \$ARG"
$ git ล่ามตัวอย่าง <
> เรื่อง
>
> ข้อความ
>
> ดู: HEAD~2
> EOF
หรือ

ข่าวสาร

ดูเพิ่มเติมที่: fe3187489d69c4 (เรื่องของคอมมิชชันที่เกี่ยวข้อง)

· กำหนดค่าเทมเพลตการคอมมิตด้วยตัวอย่างบางส่วนที่มีค่าว่าง (ใช้ sed เพื่อแสดง
และเว้นวรรคต่อท้ายตัวอย่าง) จากนั้นกำหนดค่า commit-msg
ตะขอที่ใช้ คอมไพล์ ล่ามรถพ่วง เพื่อลบรถพ่วงที่มีค่าว่างและเพิ่ม
a รุ่นคอมไพล์ รถพ่วง:

$ sed -e 's/ Z$/ /' >commit_template.txt <
> ***เรื่อง***
>
> ***ข้อความ***
>
> แก้ไข: Z
> Cc: Z
> บทวิจารณ์โดย: Z
> ลงชื่อออกโดย: Z
> EOF
$ git config commit. template commit_template.txt
$ cat >.git/hooks/commit-msg <
> #!bin / sh /
> git ล่าม-trailers --trim-empty --trailer "git-version: \$(git อธิบาย)" "\$1" > "\$1.new"
> mv "\$1.new" "\$1"
> EOF
$ chmod +x .git/hooks/commit-msg

ใช้ git-interpret-trailers ออนไลน์โดยใช้บริการ onworks.net