git-interpret-trailers - מקוון בענן

תָכְנִית:

שֵׁם

git-interpret-trailers - עוזרים להוסיף מידע מובנה להודעות commit

תַקצִיר

סילון פרשנים-נגררים [--trim-empty] [(--טריילר [(=|:) ])...] [ ...]

תיאור

עזרה בהוספה קדימונים שורות, שנראות דומות לכותרות דואר אלקטרוני RFC 822, בסוף ה-
באופן חופשי חלק מהודעת התחייבות.

פקודה זו קוראת כמה תיקונים או הודעות commit מאחד מה- טיעונים או ה
קלט סטנדרטי אם לא מצוין. ואז פקודה זו מיישמת את הארגומנטים שעברו
באמצעות האפשרות --trailer, אם יש, לחלק הודעת ה-commit של כל קובץ קלט. ה
התוצאה נפלטת על הפלט הסטנדרטי.

משתני תצורה מסוימים שולטים באופן שבו ארגומנטים --trailer מיושמים על כל אחד מהם
הודעת התחייבות והדרך שבה כל טריילר קיים בהודעת ההתחייבות משתנה. הֵם
גם מאפשרים להוסיף אוטומטית כמה טריילרים.

כברירת מחדל, א = or : ארגומנט שניתן באמצעות --trailer יהיה
מצורף אחרי הנגררים הקיימים רק אם לקרוואן האחרון יש שונה ( ,
) זוג (או אם אין נגרר קיים). ה ו חלקים יהיו
גזוז כדי להסיר רווחים התחלתיים ונגררים, והתוצאה גזומה ו
יופיע בהודעה כך:

אסימון: ערך

זה אומר שהגזוז ו יופרד על ידי ': ' (נקודתיים אחד
ואחריו רווח אחד).

כברירת מחדל, הטריילר החדש יופיע בסוף כל הקדימונים הקיימים. אם יש
אין טריילר קיים, הטריילר החדש יופיע לאחר חלק הודעת ההתחייבות של
פלט, ואם אין שורה עם רק רווחים בסוף חלק הודעת ה-commit,
שורה ריקה אחת תתווסף לפני הטריילר החדש.

נגררים קיימים נשלפים מהודעת הקלט על ידי חיפוש קבוצה של אחד או
שורות נוספות המכילות נקודתיים (כברירת מחדל), כאשר לפני הקבוצה אחת או יותר
שורות ריקות (או עם רווח לבן בלבד). הקבוצה חייבת להיות בסוף ההודעה או להיות
השורות האחרונות שאינן רווחים לבנים לפני שורה שמתחילה עם ---. שלושה סימני מינוס כאלה
התחל את חלק התיקון של ההודעה.

בעת קריאת טריילרים, יכולים להיות רווחים לבנים לפני ואחרי האסימון, המפריד
ואת הערך. יכולים להיות גם רווחים לבנים בתוך האסימון והערך.

שים לב כי קדימונים אל תפעל ולא נועדה לפעול לפי כללים רבים עבור RFC 822
כותרות. לדוגמה, הם אינם פועלים לפי כללי קיפול השורות, כללי הקידוד ו
כנראה חוקים רבים אחרים.

אפשרויות

--קצץ-ריק
אם ה חלק מכל טריילר מכיל רק רווח לבן, כל הטריילר יהיה
הוסר מההודעה שהתקבלה. זה חל על נגררים קיימים וגם על חדשים
נגררים.

--גְרוֹר [(=|:) ]
ציין ( , ) זוג שאמור להיות מיושם כקרוואן לקלט
הודעות. ראה את התיאור של פקודה זו.

תְצוּרָה וריאציות

טריילר. מפרידים
אפשרות זו אומרת אילו תווים מזוהים כמפרידי טריילר. כברירת מחדל
רק : מוכר כמפריד נגרר, מלבד זאת = תמיד מקובל על
שורת פקודה לתאימות עם פקודות git אחרות.

התו הראשון שניתן על ידי אפשרות זו יהיה תו ברירת המחדל המשמש כאשר
מפריד אחר לא מצוין בתצורה של הטריילר הזה.

לדוגמה, אם הערך עבור אפשרות זו הוא "%=$", אז רק קווים המשתמשים בפורמט
עם מֵכִיל %, = or $ ואז ישקלו רווחים
נגררים. ו % יהיה מפריד ברירת המחדל בשימוש, לכן כברירת מחדל יופיעו טריילרים
כמו: % (סימן אחוז אחד ורווח אחד יופיעו בין האסימון
והערך).

טריילר.היכן
אפשרות זו מציינת היכן יתווסף טריילר חדש.

זה יכול להיות סוף, שהוא ברירת המחדל, התחלה, אחרי או לפני.

אם זה נגמר, אז כל טריילר חדש יופיע בסוף הקדימונים הקיימים.

אם זה התחלה, אז כל טריילר חדש יופיע בהתחלה, במקום הסוף, של
הנגררים הקיימים.

אם זה אחרי, אז כל טריילר חדש יופיע מיד אחרי הטריילר האחרון עם
אותו .

אם זה לפני, אז כל טריילר חדש יופיע ממש לפני הטריילר הראשון עם
אותו הדבר .

trailer.ifexists
אפשרות זו מאפשרת לבחור איזו פעולה תתבצע כשיש
כבר לפחות טריילר אחד עם אותו הדבר בהודעה.

הערכים החוקיים עבור אפשרות זו הם: addIfDifferentNeighbor (זוהי ברירת המחדל),
addIfDifferent, הוסף, החלף או תעשה כלום.

עם addIfDifferentNeighbor, טריילר חדש יתווסף רק אם אין טריילר עם
אותו ( , ) הזוג נמצא מעל או מתחת לקו שבו יהיה הקרוואן החדש
הוסיף.

עם addIfDifferent, טריילר חדש יתווסף רק אם אין טריילר עם אותו הדבר
( , ) הצמד כבר נמצא בהודעה.

עם הוספה, יתווסף טריילר חדש, גם אם כמה טריילרים עם אותו ( ,
) הצמד כבר נמצא בהודעה.

עם להחליף, נגרר קיים עם אותו הדבר יימחק והחדש
יתווסף טריילר. הטריילר שנמחק יהיה הקרוב ביותר (עם אותו
) למקום שבו יתווסף החדש.

עם doNothing, שום דבר לא ייעשה; כלומר, לא יתווסף טריילר חדש אם יש
כבר אחד עם אותו הדבר בהודעה.

טריילר.אם חסר
אפשרות זו מאפשרת לבחור איזו פעולה תתבצע כשיש
עדיין אין טריילר עם אותו הדבר בהודעה.

הערכים החוקיים עבור אפשרות זו הם: add (זוהי ברירת המחדל) ו-doNothing.

עם הוספה, יתווסף טריילר חדש.

עם doNothing, שום דבר לא ייעשה.

גְרוֹר. .מַפְתֵחַ
המפתח הזה ישמש במקום בטריילר. בסוף מפתח זה, א
מפריד יכול להופיע ולאחר מכן כמה תווי רווח. כברירת מחדל התוקף היחיד
מפריד הוא :, אך ניתן לשנות זאת באמצעות משתנה התצורה trailer.separators.

אם יש מפריד, המפתח ישמש במקום שני וה
מפריד ברירת מחדל בעת הוספת הטריילר.

גְרוֹר. .איפה
אפשרות זו לוקחת את אותם ערכים כמו ה- טריילר.היכן משתנה תצורה וזה
עוקף את מה שצוין באופציה זו עבור נגררים עם ההגדרה המצוינת .

גְרוֹר. .ifexist
אפשרות זו לוקחת את אותם ערכים כמו ה- trailer.ifexist משתנה תצורה וזה
עוקף את מה שצוין באופציה זו עבור נגררים עם ההגדרה המצוינת .

גְרוֹר. .אם חסר
אפשרות זו לוקחת את אותם ערכים כמו ה- טריילר.אם חסר משתנה תצורה ו
הוא עוקף את מה שצוין באופציה זו עבור נגררים עם ההגדרה המצוינת .

גְרוֹר. .פקודה
ניתן להשתמש באפשרות זו כדי לציין פקודת מעטפת שאליה ייקרא
הוסף או שנה אוטומטית טריילר עם המצוין .

כאשר אפשרות זו מצוינת, ההתנהגות היא כאילו מיוחדת =
ארגומנט נוספו בתחילת שורת הפקודה, שם נתפס להיות
הפלט הסטנדרטי של הפקודה שצוינה עם כל רווח לבן מוביל ונמשך
גזוז.

אם הפקודה מכילה את המחרוזת $ARG, מחרוזת זו תוחלף ב-
חלק מקרוואן קיים עם אותו הדבר , אם בכלל, לפני הפקודה היא
MANAG מספר

אם כמה = ארגומנטים מועברים גם בשורת הפקודה, כאשר א
גְרוֹר. .פקודה מוגדר, הפקודה תבוצע גם עבור כל אחד מהם
הטיעונים הללו. וה חלק מהטיעונים הללו, אם בכלל, ישמשו
החלף את מחרוזת $ARG בפקודה.

דוגמאות

· הגדר את א סִימָן קרוואן עם א חתום על ידי מפתח, ולאחר מכן הוסף שניים מהטריילרים הללו
להודעה:

$ git config trailer.sign.key "Signed-off-by"
$ cat msg.txt
נושא

הודעה
$ cat msg.txt | git interpret-trailers --trailer 'סימן: אליס[מוגן בדוא"ל]>' --trailer 'סימן: בוב[מוגן בדוא"ל]>'
נושא

הודעה

חתום על ידי: אליס[מוגן בדוא"ל]>
חתום על ידי: בוב[מוגן בדוא"ל]>

· חלץ את ה-commit האחרון כתיקון, והוסף א Cc וכן נסקר על ידי טריילר לזה:

$ git format-patch -1
0001-foo.patch
$ git interpret-trailers --trailer 'Cc: Alice[מוגן בדוא"ל]>' --trailer 'נבדק על ידי: בוב[מוגן בדוא"ל]>' 0001-foo.patch >0001-bar.patch

· הגדר את א סִימָן טריילר עם פקודה להוספה אוטומטית של 'Signed-off-by: ' עם
מידע המחבר רק אם אין כבר 'חתום על ידי:', והראה איך זה
עבודות:

$ git config trailer.sign.key "Signed-off-by: "
$ git config trailer.sign.ifmissing הוסף
$ git config trailer.sign.ifexists doNothing
$ git config trailer.sign.command 'echo "$(git config user.name) <$(git config user.email)>"'
$ git interpret-trailers <
> EOF

חתום על ידי: בוב[מוגן בדוא"ל]>
$ git interpret-trailers <
> חתום על ידי: אליס[מוגן בדוא"ל]>
> EOF

חתום על ידי: אליס[מוגן בדוא"ל]>

· הגדר את א קבוע נגרר עם מפתח המכיל א # ואין מקום אחרי זה
דמות, ולהראות איך זה עובד:

$ git config trailer.separators ":#"
$ git config trailer.fix.key "תיקון #"
$ echo "נושא" | git interpret-trailers --trailer fix=42
נושא

תיקון מס' 42

· הגדר את א לִרְאוֹת טריילר עם פקודה להראות את הנושא של commit כלומר
קשור, והראה איך זה עובד:

$ git config trailer.see.key "ראה-גם:"
$ git config trailer.see.ifExists "replace"
$ git config trailer.see.if חסר "doNothing"
$ git config trailer.see.command "git log -1 --oneline --format=\"%h (%s)\" --abbrev-commit --abbrev=14 \$ARG"
$ git interpret-trailers <
> נושא
>
> הודעה
>
> ראה: HEAD~2
> EOF
נושא

הודעה

ראה גם: fe3187489d69c4 (נושא ההתחייבות הקשורה)

· הגדר תבנית commit עם כמה טריילרים עם ערכים ריקים (באמצעות sed כדי להראות
ושמור את הרווחים הנגררים בקצה הטריילרים), ואז הגדר commit-msg
וו שמשתמש סילון פרשנים-נגררים להסיר נגררים עם ערכים ריקים ולהוסיף
a גרסת git גְרוֹר:

$ sed -e 's/ Z$/ /' >commit_template.txt <
> ***נושא***
>
> ***הודעה***
>
> תיקונים: Z
> עותק: ז
> נבדק על ידי: Z
> חתום על ידי: 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

השתמש ב-git-interpret-trailers באינטרנט באמצעות שירותי onworks.net