git-interpret-trailers - онлайн у хмарі

ПРОГРАМА:

ІМ'Я

git-interpret-trailers - допомагають додавати структуровану інформацію в повідомлення комітів

СИНТАКСИС

мерзотник перекладачі [--trim-empty] [(--trailer [(=|:) ])...] [ ...]

ОПИС

Допоможіть додати причепи рядків, які схожі на заголовки електронної пошти RFC 822, у кінці
інакше довільна частина повідомлення про фіксацію.

Ця команда зчитує деякі патчі або повідомлення про фіксацію з будь-якого аргументи або
стандартний вхід, якщо ні вказано. Потім ця команда застосовує передані аргументи
використовуючи параметр --trailer, якщо є, до частини повідомлення про фіксацію кожного вхідного файлу. The
результат виводиться на стандартний вихід.

Деякі змінні конфігурації контролюють спосіб застосування аргументів --trailer до кожної з них
повідомлення про фіксацію та спосіб зміни будь-якого наявного трейлера в повідомленні фіксації. Вони
також дозволяє автоматично додавати деякі трейлери.

За замовчуванням, a = or : Аргумент, наведений за допомогою --trailer, буде
додається після наявних трейлерів, лише якщо останній трейлер має інший ( ,
) пара (або якщо немає наявного трейлера). The і частини будуть
обрізаний, щоб видалити початкові та кінцеві пробіли, а отриманий обрізаний і
з'явиться в повідомленні таким чином:

токен: значення

Це означає, що обрізаний і будуть розділені символом ": " (одна двокрапка
після якого один пробіл).

За замовчуванням новий трейлер з’явиться в кінці всіх існуючих трейлерів. Якщо там
немає існуючого трейлера, новий трейлер з’явиться після частини повідомлення про фіксацію
висновок, і, якщо немає рядка з пробілами в кінці повідомлення про фіксацію,
один порожній рядок буде додано перед новим трейлером.

Існуючі трейлери витягуються з вхідного повідомлення шляхом пошуку групи з одного або
більше рядків, які містять двокрапку (за замовчуванням), де групі передує один або кілька
порожні (або лише пробіли) рядки. Група має бути або в кінці повідомлення, або бути
останні рядки без пробілів перед рядком, який починається з ---. Таких три знака мінус
розпочати виправлення частини повідомлення.

Під час читання трейлерів перед і після маркера, роздільника, можуть бути пробіли
і значення. Усередині маркера та значення також можуть бути пробіли.

Зверніть увагу, що причепи не дотримуються та не призначені для дотримання багатьох правил для RFC 822
заголовки. Наприклад, вони не дотримуються правил згортання рядків, правил кодування та
напевно багато інших правил.

ВАРІАНТИ

--обрізний-порожній
Якщо частина будь-якого трейлера містить лише пробіли, весь трейлер буде
видалено з отриманого повідомлення. Це стосується як існуючих, так і нових причепів
причепи.

-- трейлер [(=|:) ]
Вкажіть ( , ) пара, яку слід застосувати як кінцеву інформацію до входу
повідомлення. Дивіться опис цієї команди.

КОНФІГУРАЦІЯ ЗМІННІ

причіп.сепаратори
Ця опція вказує, які символи розпізнаються як роздільники кінцевого тексту. За замовчуванням
тільки : визнається як роздільник причепа, за винятком того = завжди приймається на
командний рядок для сумісності з іншими командами git.

Перший символ, наданий цією опцією, буде символом за замовчуванням, який використовується, коли
інший роздільник не вказано в конфігурації для цього трейлера.

Наприклад, якщо значення для цієї опції "%=$", то лише рядки, що використовують формат
з що містить %, = or $ а потім будуть розглянуті пробіли
причепи. І % буде використовуватися роздільник за замовчуванням, тому за замовчуванням з’являться трейлери
подібно до: % (між маркером з’явиться один знак відсотка та один пробіл
і вартість).

трейлер.де
Ця опція вказує, де буде додано новий трейлер.

Це може бути кінець, який є за замовчуванням, початок, після або до.

Якщо це кінець, то кожен новий трейлер з’являтиметься в кінці наявних трейлерів.

Якщо це початок, то кожен новий трейлер з’являтиметься на початку, а не в кінці
наявні причепи.

Якщо це після, то кожен новий трейлер з’являтиметься відразу після останнього трейлера з
те саме .

Якщо це було раніше, то кожен новий трейлер з’являтиметься безпосередньо перед першим трейлером з
так само .

trailer.ifexists
Ця опція дає можливість вибрати, яку дію буде виконуватися, коли є
вже принаймні один трейлер з таким же у повідомленні.

Допустимі значення для цього параметра: addIfDifferentNeighbor (це за замовчуванням),
addIfDifferent, додати, перезаписати або нічого не робити.

За допомогою addIfDifferentNeighbor новий трейлер буде додано, лише якщо немає трейлера з
те саме ( , ) пара знаходиться вище або нижче лінії, де буде новий трейлер
доданий.

За допомогою addIfDifferent новий трейлер буде додано, лише якщо немає причепа з таким самим
( , ) пара вже є в повідомленні.

За допомогою додавання буде додано новий трейлер, навіть якщо деякі трейлери з таким самим ( ,
) пара вже в повідомленні.

З заміною, наявний причіп на такий самий буде видалено, а нове
буде додано трейлер. Видалений трейлер буде найближчим (з таким самим
) до місця, де буде додано новий.

З doNothing нічого не буде зроблено; тобто новий трейлер не буде додано, якщо є
вже один з тим же у повідомленні.

trailer.ifmissing
Ця опція дає можливість вибрати, яку дію буде виконуватися, коли є
ще немає жодного трейлера з таким же у повідомленні.

Допустимі значення для цієї опції: add (це за замовчуванням) і doNothing.

Після додавання буде додано новий трейлер.

З doNothing нічого не буде зроблено.

трейлер. .ключ
Цей ключ буде використовуватися замість в трейлері. У кінці цього ключа а
може з'явитися роздільник, а потім кілька пробілів. За замовчуванням єдиний дійсний
роздільник є :, але це можна змінити за допомогою змінної конфігурації trailer.separators.

Якщо є роздільник, то замість обох буде використовуватися ключ і
роздільник за замовчуванням під час додавання трейлера.

трейлер. .де
Цей параметр приймає ті ж значення, що і параметр трейлер.де змінна конфігурації і це
замінює те, що визначено цим параметром для трейлерів із зазначеним .

трейлер. .ifexist
Цей параметр приймає ті ж значення, що і параметр trailer.ifexist змінна конфігурації і це
замінює те, що визначено цим параметром для трейлерів із зазначеним .

трейлер. .відпускає
Цей параметр приймає ті ж значення, що і параметр trailer.ifmissing змінна конфігурації та
він замінює те, що визначено цим параметром для трейлерів із зазначеним .

трейлер. .command
Цей параметр можна використовувати для визначення команди оболонки, до якої буде викликано
автоматично додавати або змінювати трейлер із зазначеним .

Коли вказано цю опцію, поведінка є як би особливою =
аргумент було додано на початку командного рядка, де вважається таким
стандартний висновок зазначеної команди з будь-якими провідними та кінцевими пробілами
обрізаний.

Якщо команда містить рядок $ARG, цей рядок буде замінено на
частина існуючого причепа з таким же , якщо є, перед командою
запущений

Якщо якісь = аргументи також передаються в командному рядку, коли a
трейлер. .command налаштовано, команда також буде виконана для кожного з
ці аргументи. І частина цих аргументів, якщо такі є, буде використана
замініть рядок $ARG у команді.

ПРИКЛАДИ

· Налаштувати а підпис причіп з a Підписаний ключ, а потім додайте два з цих трейлерів
на повідомлення:

$ git config trailer.sign.key "Підписаний"
$ cat msg.txt
тема

повідомлення
$ cat msg.txt | git interpret-trailers --trailer 'sign: Аліса[захищено електронною поштою]>' --trailer 'знак: Боб[захищено електронною поштою]>'
тема

повідомлення

Підписаний: Аліса[захищено електронною поштою]>
Підписаний: Боб[захищено електронною поштою]>

· Витягніть останній комміт як патч і додайте a Cc і Переглянуто трейлер до нього:

$ git format-patch -1
0001-foo.patch
$ git interpret-trailers --trailer 'Копія: Аліса[захищено електронною поштою]>' --trailer 'Переглянув: Боб[захищено електронною поштою]>' 0001-foo.patch >0001-bar.patch

· Налаштувати а підпис трейлер із командою для автоматичного додавання 'Signed-off-by: ' with
інформація про автора, лише якщо вже немає "Signed-off-by: ", і покажіть, як це
робіт:

$ git config trailer.sign.key "Підписаний: "
$ 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 "Виправити #"
$ echo "предмет" | git interpret-trailers --trailer fix=42
тема

Виправлення №42

· Налаштувати а побачити трейлер з командою, щоб показати тему коміту, тобто
пов’язані та показати, як це працює:

$ git config trailer.see.key "Див. також: "
$ git config trailer.see.ifExists "замінити"
$ 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 <
> предмет
>
> повідомлення
>
> див.: ГОЛОВКА~2
> EOF
тема

повідомлення

Дивіться також: fe3187489d69c4 (предмет пов’язаного фіксації)

· Налаштуйте шаблон фіксації з деякими трейлерами з порожніми значеннями (за допомогою 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 <
> #!/ Бен / ш
> 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