git-интерпретация-трейлеры - Интернет в облаке

ПРОГРАММА:

ИМЯ

git-интерпретация-трейлеры - помогите добавить структурированную информацию в сообщения фиксации

СИНТАКСИС

мерзавец прицепы-переводчики [--trim-empty] [(--trailer [(= | :) ]) ...] [ ...]

ОПИСАНИЕ

Помогите добавить прицепы строки, похожие на заголовки электронной почты RFC 822, в конце
в противном случае - часть сообщения фиксации в свободной форме.

Эта команда считывает некоторые исправления или сообщения фиксации из любого аргументы или
стандартный ввод, если нет указан. Затем эта команда применяет переданные аргументы
используя параметр --trailer, если он есть, для части сообщения фиксации каждого входного файла. В
результат выводится на стандартный вывод.

Некоторые переменные конфигурации определяют способ применения аргументов --trailer к каждому
сообщение фиксации и способ изменения любого существующего трейлера в сообщении фиксации. Они
также позволяют автоматически добавлять трейлеры.

По умолчанию знак равно or : аргумент, указанный с помощью --trailer, будет
добавляется после существующих трейлеров, только если последний трейлер имеет другой ( ,
) пара (или если прицепа нет). В а также части будут
обрезан, чтобы удалить начальные и конечные пробелы, а результирующий обрезанный а также
появится в сообщении следующим образом:

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

Это означает, что обрезанный а также будут разделены знаком ":" (одно двоеточие
с последующим одним пробелом).

По умолчанию новый трейлер появится в конце всех существующих трейлеров. Если там
нет существующего трейлера, новый трейлер появится после части сообщения фиксации
output, и, если в конце части сообщения фиксации нет строки с пробелами,
перед новым трейлером будет добавлена ​​одна пустая строка.

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

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

Обратите внимание, что прицепы не соблюдают и не предназначены для соблюдения многих правил RFC 822
заголовки. Например, они не соблюдают правила переноса строк, правила кодирования и
наверное много других правил.

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

--trim-пусто
Если часть любого трейлера содержит только пробелы, весь трейлер будет
удалено из полученного сообщения. Это касается как существующих, так и новых прицепов.
прицепы.

- трейлер [(= | :) ]
Укажите ( , ) пара, которая должна быть применена как трейлер к входу
Сообщения. См. Описание этой команды.

КОНФИГУРАЦИЯ ПЕРЕМЕННЫЕ

прицеп. сепараторы
Эта опция сообщает, какие символы распознаются как разделители прицепов. По умолчанию
только : распознается как разделитель прицепа, за исключением того, что = всегда принимается на
командная строка для совместимости с другими командами git.

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

Например, если значение этого параметра - «% = $», то только строки, использующие формат
с участием содержащий %, = or $ а затем будут считаться пробелы
прицепы. А также % будет используемым разделителем по умолчанию, поэтому по умолчанию будут отображаться трейлеры
как: % (между токеном появится один знак процента и один пробел
и значение).

трейлер. где
Эта опция сообщает, где будет добавлен новый трейлер.

Это может быть конец по умолчанию, начало, после или до.

Если это конец, то каждый новый трейлер будет появляться в конце существующих трейлеров.

Если это начало, то каждый новый трейлер будет отображаться в начале, а не в конце
существующие прицепы.

Если это будет после, то каждый новый трейлер будет появляться сразу после последнего трейлера с
тем же .

Если это раньше, то каждый новый трейлер будет появляться непосредственно перед первым трейлером с
такой же .

трейлер. существует
Эта опция позволяет выбрать, какое действие будет выполняться при наличии
уже как минимум один трейлер с таким же в сообщении.

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

С addIfDifferentNeighbor новый трейлер будет добавлен только в том случае, если нет трейлера с
тем же ( , ) пара находится выше или ниже линии, где будет находиться новый трейлер.
добавлен.

С addIfDifferent новый трейлер будет добавлен только в том случае, если нет трейлера с таким же
( , ) пара уже есть в сообщении.

При добавлении будет добавлен новый трейлер, даже если некоторые трейлеры с таким же ( ,
) пара уже есть в сообщении.

При замене существующий прицеп с таким же будут удалены, а новый
будет добавлен трейлер. Удаленный трейлер будет ближайшим (с таким же
) на место, где будет добавлен новый.

С doNothing ничего не будет сделано; то есть новый трейлер не будет добавлен, если есть
уже один с таким же в сообщении.

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

Допустимые значения для этой опции: add (это значение по умолчанию) и doNothing.

С добавлением будет добавлен новый трейлер.

С doNothing ничего делать не будет.

трейлер. .ключ
Этот ключ будет использоваться вместо в трейлере. В конце этого ключа
может появиться разделитель, а затем несколько пробелов. По умолчанию единственный действительный
разделитель :, но это можно изменить с помощью переменной конфигурации trailer.separators.

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

трейлер. .куда
Эта опция принимает те же значения, что и трейлер. где переменная конфигурации и это
отменяет то, что указано этой опцией для трейлеров с указанным .

трейлер. .ifexist
Эта опция принимает те же значения, что и трейлер.ifexist переменная конфигурации и это
отменяет то, что указано этой опцией для трейлеров с указанным .

трейлер. .ifmissing
Эта опция принимает те же значения, что и трейлер. пропавший без вести переменная конфигурации и
он отменяет то, что указано этой опцией для трейлеров с указанным .

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

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

Если команда содержит строку $ ARG, эта строка будет заменена на
часть существующего трейлера с таким же , если есть, перед командой
запущен.

Если некоторые знак равно аргументы также передаются в командной строке, когда
трейлер. .command настроен, команда также будет выполняться для каждого из
эти аргументы. И часть этих аргументов, если таковые имеются, будет использована для
замените строку $ ARG в команде.

ПРИМЕРЫ

· Настроить подпись трейлер с Подписано пользователем ключ, а затем добавьте два таких трейлера
к сообщению:

$ git config trailer.sign.key "Подписано пользователем"
$ кошка msg.txt
предмет

сообщение
$ cat msg.txt | git interp-trailers --trailer 'знак: Алиса[электронная почта защищена]> знак '--trailer': Боб[электронная почта защищена]>'
предмет

сообщение

Подписано: Алиса[электронная почта защищена]>
Подписано: Боб[электронная почта защищена]>

· Извлеките последнюю фиксацию как патч и добавьте Cc и еще один Рассмотрено прицеп к нему:

$ git формат-патч -1
0001-foo.patch
$ git интерпретация-трейлеры --trailer 'Копия: Алиса[электронная почта защищена]> '--trailer' Автор обзора: Боб[электронная почта защищена]> '0001-foo.patch> 0001-bar.patch

· Настроить подпись трейлер с командой для автоматического добавления подписанного пользователя с
информация об авторе только в том случае, если еще не было подписано пользователем, и показать, как это сделать
работ:

$ 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

Подписано: Боб[электронная почта защищена]>
$ git интерпретатор-трейлеры <
> Подписано: Алиса[электронная почта защищена]>
> EOF

Подписано: Алиса[электронная почта защищена]>

· Настроить фиксировать трейлер с ключом, который содержит # и нет места после этого
персонаж, и покажите, как это работает:

$ git config trailer.separators ": #"
$ git config trailer.fix.key "Исправить #"
$ echo "тема" | git интерпретатор-трейлеры --trailer fix = 42
предмет

Исправление № 42

· Настроить посмотреть трейлер с командой, чтобы показать тему коммита, который
связанных, и покажите, как это работает:

$ git config trailer.see.key "См. также:"
$ git config trailer.see.if Существует "заменить"
$ git config trailer.see.if Отсутствует "doNothing"
$ 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 git-версия прицеп:

$ sed -e 's / Z $ / /'> commit_template.txt <
> *** тема ***
>
> *** сообщение ***
>
> Исправления: Z
> Копия: Z
> Проверено: Z
> Подписано: Z
> EOF
$ git config commit.template commit_template.txt
$ кошка> .git / крючки / коммит-сообщение <
> #!/ Бен / ш
> git интерпретатор-трейлеры --trim-empty --trailer "git-version: \ $ (git describe)" "\ $ 1"> "\ $ 1.new"
> mv "\ $ 1.new" "\ $ 1"
> EOF
$ chmod + x .git / крючки / коммит-сообщение

Используйте git-интерпретатор-трейлеры онлайн с помощью сервисов onworks.net