git-interpret-trailers - آنلاین در ابر

برنامه:

نام

git-interpret-trailers - به افزودن اطلاعات ساختاریافته به پیام های commit کمک می کند

خلاصه

دستگاه گوارش تریلر تفسیر [--trim-empty] [(--تریلر [(=|:) ])...] [ ...]

شرح

کمک به اضافه کردن تریلر خطوطی که شبیه هدرهای ایمیل RFC 822 هستند، در انتهای صفحه
در غیر این صورت بخشی از یک پیام commit است.

این دستور برخی از وصله‌ها را می‌خواند یا پیام‌های commit را از هر دو می‌خواند استدلال یا
ورودی استاندارد اگر نه مشخص شده است. سپس این دستور آرگومان های ارسال شده را اعمال می کند
با استفاده از گزینه --trailer، در صورت وجود، به بخش commit پیام هر فایل ورودی. در
نتیجه بر روی خروجی استاندارد منتشر می شود.

برخی از متغیرهای پیکربندی نحوه اعمال آرگومان های --trailer را برای هر کدام کنترل می کنند
پیام commit و نحوه هر تریلر موجود در پیام commit تغییر می کند. آنها
همچنین امکان افزودن خودکار برخی از تریلرها را فراهم می کند.

به طور پیش فرض ، a = or : آرگومان داده شده با استفاده از --trailer خواهد بود
فقط در صورتی که آخرین تریلر متفاوت باشد، پس از تریلرهای موجود اضافه می شود ( ،
) جفت (یا اگر تریلر موجود نباشد). در و قطعات خواهد بود
برای حذف فضای خالی ابتدایی و انتهایی، برش داده می شود و فضای به دست آمده بریده می شود و
در پیام به این صورت ظاهر می شود:

نشانه: ارزش

این بدان معنی است که کوتاه شده است و با ": " از هم جدا می شود (یک کولن
به دنبال آن یک فاصله).

به طور پیش فرض تریلر جدید در انتهای تمام تریلرهای موجود ظاهر می شود. اگر آنجا
تریلر موجود نیست، تریلر جدید بعد از بخش پیام commit ظاهر می شود
خروجی، و اگر خطی با فاصله در انتهای قسمت پیام commit وجود نداشته باشد،
یک خط خالی قبل از تریلر جدید اضافه خواهد شد.

تریلرهای موجود با جستجوی گروهی از یک یا از پیام ورودی استخراج می شوند
خطوط بیشتری که حاوی یک دونقطه (به طور پیش فرض) هستند، جایی که قبل از گروه یک یا چند وجود دارد
خطوط خالی (یا فقط با فضای خالی). گروه یا باید در انتهای پیام باشد یا باشد
آخرین خطوط بدون فاصله قبل از خطی که با آن شروع می شود ---. چنین سه علامت منفی
قسمت Patch پیام را شروع کنید.

هنگام خواندن تریلرها، قبل و بعد از نشانه، جداکننده، ممکن است فضاهای خالی وجود داشته باشد
و ارزش همچنین ممکن است در داخل نشانه و مقدار فضاهای خالی وجود داشته باشد.

توجه داشته باشید که تریلر از بسیاری از قوانین RFC 822 پیروی نمی کنند و در نظر گرفته نشده اند
سرصفحه ها به عنوان مثال آنها از قوانین تاشو خط، قوانین رمزگذاری و
احتمالاً بسیاری از قوانین دیگر

OPTIONS

- خالی کردن
اگر بخشی از هر تریلر فقط حاوی فضای خالی است، کل تریلر خواهد بود
از پیام به دست آمده حذف شد. این امر در مورد تریلرهای موجود و همچنین جدید صدق می کند
تریلر

--تریلر [(=|:) ]
یک ( ، ) جفتی که باید به عنوان تریلر در ورودی اعمال شود
پیام ها. توضیحات این دستور را ببینید.

پیکربندی متغیرها

تریلر.جداکننده
این گزینه نشان می دهد که کدام شخصیت ها به عنوان جداکننده تریلر شناخته می شوند. به صورت پیش فرض
فقط : به عنوان جداکننده تریلر شناخته می شود، با این تفاوت که = همیشه در مورد پذیرفته می شود
خط فرمان برای سازگاری با سایر دستورات git.

اولین کاراکتر داده شده توسط این گزینه، کاراکتر پیش فرضی خواهد بود که در زمانی که استفاده می شود
جداکننده دیگری در پیکربندی این تریلر مشخص نشده است.

به عنوان مثال، اگر مقدار این گزینه "%=$" باشد، فقط خطوطی که از قالب استفاده می کنند
با حاوی %, = or $ و سپس فضاها در نظر گرفته می شود
تریلرها و % جداکننده پیش فرض مورد استفاده خواهد بود، بنابراین به طور پیش فرض تریلرها ظاهر می شوند
پسندیدن: % (یک درصد علامت و یک فاصله بین نشانه ظاهر می شود
و ارزش).

تریلر.کجا
این گزینه می گوید کجا یک تریلر جدید اضافه خواهد شد.

این می تواند پایان باشد، که پیش فرض، شروع، بعد یا قبل است.

اگر پایان باشد، هر تریلر جدید در انتهای تریلرهای موجود ظاهر می شود.

اگر شروع باشد، هر تریلر جدید به جای پایان، در ابتدا ظاهر می شود
تریلرهای موجود

اگر بعد از آن باشد، هر تریلر جدید درست بعد از آخرین تریلر همراه با نمایش داده می شود
یکسان .

اگر قبل از آن باشد، هر تریلر جدید درست قبل از اولین تریلر با ظاهر می شود
همان .

trailer.ifexists
این گزینه این امکان را فراهم می کند که انتخاب کنید در صورت وجود چه اقدامی انجام شود
در حال حاضر حداقل یک تریلر با همان در پیام

مقادیر معتبر برای این گزینه عبارتند از: addIfDifferentNeighbor (این پیش فرض است)،
addIfDifferent، اضافه کردن، بازنویسی یا انجام هیچ چیز.

با addIfDifferentNeighbor، فقط در صورتی که تریلر همراه با آن نباشد، تریلر جدیدی اضافه می‌شود
یکسان ( ، ) جفت بالا یا پایین خطی است که تریلر جدید در آن قرار دارد
اضافه شده است.

با addIfDifferent، فقط در صورتی که تریلر مشابهی نداشته باشد، تریلر جدیدی اضافه خواهد شد
( ، ) جفت قبلاً در پیام است.

با افزودن، یک تریلر جدید اضافه خواهد شد، حتی اگر برخی از تریلرهای مشابه ( ،
) جفت از قبل در پیام هستند.

با جایگزینی، یک تریلر موجود با همان حذف خواهد شد و جدید
تریلر اضافه خواهد شد تریلر حذف شده نزدیکترین تریلر خواهد بود (با همان
) به محلی که مورد جدید اضافه می شود.

با doNothing، هیچ کاری انجام نخواهد شد. که در صورت وجود تریلر جدیدی اضافه نخواهد شد
در حال حاضر یکی با همان در پیام

trailer.ifmissing
این گزینه این امکان را فراهم می کند که انتخاب کنید در صورت وجود چه اقدامی انجام شود
هنوز هیچ تریلر با همان در پیام

مقادیر معتبر برای این گزینه عبارتند از: add (این پیش فرض است) و doNothing.

با افزودن، تریلر جدیدی اضافه خواهد شد.

با doNothing هیچ کاری انجام نخواهد شد.

تریلر. کلید
این کلید به جای استفاده خواهد شد در تریلر در انتهای این کلید، الف
جداکننده می تواند ظاهر شود و سپس چند کاراکتر فاصله. به طور پیش فرض تنها معتبر است
جداکننده است :، اما این را می توان با استفاده از متغیر پیکربندی trailer.separators تغییر داد.

اگر جداکننده وجود داشته باشد، از کلید به جای هر دو استفاده می شود و
جداکننده پیش فرض هنگام اضافه کردن تریلر.

تریلر. .جایی که
این گزینه همان مقادیر را می گیرد تریلر.کجا متغیر پیکربندی و آن
مواردی را که توسط آن گزینه برای تریلرهایی با موارد مشخص شده مشخص شده است، لغو می کند .

تریلر. وجود دارد
این گزینه همان مقادیر را می گیرد تریلر.ifexist متغیر پیکربندی و آن
مواردی را که توسط آن گزینه برای تریلرهایی با موارد مشخص شده مشخص شده است، لغو می کند .

تریلر. .نداشتن
این گزینه همان مقادیر را می گیرد trailer.ifmissing متغیر پیکربندی و
آن چیزی را که توسط آن گزینه برای تریلرهایی با مقدار مشخص شده مشخص شده است لغو می کند .

تریلر. .فرماندهی
از این گزینه می توان برای تعیین دستور پوسته ای که فراخوانی می شود استفاده کرد
به طور خودکار یک تریلر را با موارد مشخص شده اضافه یا تغییر دهید .

هنگامی که این گزینه مشخص می شود، رفتار مانند یک خاص است =
آرگومان در ابتدای خط فرمان، جایی که گرفته شده است
خروجی استاندارد دستور مشخص شده با هر فضای خالی پیشرو و انتهایی
کوتاه شده

اگر دستور حاوی رشته $ARG باشد، این رشته با رشته جایگزین می شود
بخشی از یک تریلر موجود با همان ، در صورت وجود، قبل از دستور است
راه اندازی شد.

اگر برخی = آرگومان ها نیز در خط فرمان ارسال می شوند، زمانی که a
تریلر. .فرماندهی پیکربندی شده است، دستور نیز برای هر یک از آنها اجرا خواهد شد
این استدلال ها و بخشی از این استدلال ها، در صورت وجود، استفاده خواهد شد
رشته $ARG را در دستور جایگزین کنید.

مثال ها

· پیکربندی a امضاء تریلر با الف امضا شده توسط کلید، و سپس دو تا از این تریلرها را اضافه کنید
به یک پیام:

$ git config trailer.sign.key "Signed-off-by"
$ cat msg.txt
موضوع

پیام
$ cat msg.txt | git interpret-trailers --trailer 'sign: Alice[ایمیل محافظت شده]>' --trailer 'sign: Bob[ایمیل محافظت شده]>'
موضوع

پیام

امضا شده توسط: آلیس[ایمیل محافظت شده]>
امضا شده توسط: باب[ایمیل محافظت شده]>

· آخرین commit را به عنوان یک پچ استخراج کنید و a را اضافه کنید Cc و یک بازبینی شده توسط تریلر آن:

$ git format -patch -1
0001-foo.patch
$ git interpret-trailers --trailer 'Cc: Alice[ایمیل محافظت شده]>' --تریلر 'بازبینی شده توسط: باب[ایمیل محافظت شده]>' 0001-foo.patch >0001-bar.patch

· پیکربندی a امضاء تریلر با دستور اضافه کردن خودکار «Signed-off-by:» با
اطلاعات نویسنده فقط در صورتی که "امضا شده توسط:" وجود نداشته باشد، و نحوه آن را نشان دهید
این نسخهها کار میکند:

$ git config trailer.sign.key "Signed-off-by:"
$ 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

امضا شده توسط: باب[ایمیل محافظت شده]>
$ git interpret-trailers <
> امضا شده توسط: آلیس[ایمیل محافظت شده]>
> EOF

امضا شده توسط: آلیس[ایمیل محافظت شده]>

· پیکربندی a تعمیر تریلر با یک کلید که حاوی الف # و بعد از این هیچ فضایی وجود ندارد
شخصیت، و نحوه عملکرد آن را نشان دهید:

$ git config trailer.separators ":#"
$ git config trailer.fix.key "Fix #"
$ echo "موضوع" | git interpret-trailers --trailer fix=42
موضوع

رفع شماره 42

· پیکربندی a دیدن تریلر با دستوری برای نشان دادن موضوع یک commit که هست
مرتبط است، و نشان می دهد که چگونه کار می کند:

$ git config trailer.see.key "See-aso:"
$ 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
> امضا شده توسط: Z
> EOF
$ git config commit.template commit_template.txt
$ cat >.git/hooks/commit-msg <
> #!/ بن / شل
> 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 به صورت آنلاین با استفاده از خدمات onworks.net استفاده کنید