git-interpret-trailers - Online na nuvem

PROGRAMA:

NOME

git-interpret-trailers - ajuda a adicionar informações estruturadas em mensagens de confirmação

SINOPSE

git interpretar trailers [--trim-empty] [(--trailer [(= | :) ]) ...] [ ...]

DESCRIÇÃO

Ajuda para adicionar reboques linhas, que parecem semelhantes aos cabeçalhos de e-mail RFC 822, no final do
caso contrário, parte de forma livre de uma mensagem de confirmação.

Este comando lê alguns patches ou mensagens de confirmação de qualquer um dos argumentos ou o
entrada padrão se não é especificado. Então este comando aplica os argumentos passados
usando a opção --trailer, se houver, para a parte da mensagem de confirmação de cada arquivo de entrada. o
resultado é emitido na saída padrão.

Algumas variáveis ​​de configuração controlam a forma como os argumentos --trailer são aplicados a cada
mensagem de confirmação e a forma como qualquer trailer existente na mensagem de confirmação é alterado. Elas
também permitem adicionar automaticamente alguns trailers.

Por padrão, um = or : argumento fornecido usando --trailer será
anexado após os trailers existentes apenas se o último trailer tiver um ( ,
) par (ou se não houver reboque existente). o e partes serão
aparado para remover os espaços em branco iniciais e finais, e o resultado aparado e
aparecerá na mensagem assim:

token: valor

Isso significa que o e será separado por ':' (um dois pontos
seguido por um espaço).

Por padrão, o novo trailer aparecerá no final de todos os trailers existentes. Se lá
não houver um trailer existente, o novo trailer aparecerá após a parte da mensagem de confirmação do
saída, e, se não houver nenhuma linha com apenas espaços no final da parte da mensagem de confirmação,
uma linha em branco será adicionada antes do novo trailer.

Os trailers existentes são extraídos da mensagem de entrada procurando por um grupo de um ou
mais linhas que contêm dois pontos (por padrão), onde o grupo é precedido por um ou mais
linhas vazias (ou apenas espaços em branco). O grupo deve estar no final da mensagem ou ser
as últimas linhas sem espaço em branco antes de uma linha que começa com ---. Esses três sinais de menos
iniciar a parte do patch da mensagem.

Ao ler trailers, pode haver espaços em branco antes e depois do token, o separador
e o valor. Também pode haver espaços em branco dentro do token e do valor.

Observe que reboques não seguem e não pretendem seguir muitas regras para RFC 822
cabeçalhos. Por exemplo, eles não seguem as regras de dobragem de linha, as regras de codificação e
provavelmente muitas outras regras.

OPÇÕES

--trim-vazio
Se o parte de qualquer trailer contém apenas espaços em branco, todo o trailer será
removido da mensagem resultante. Isso se aplica a trailers existentes e também a novos
trechos de um filme.

--reboque [(= | :) ]
Especifique um ( , ) par que deve ser aplicado como um trailer à entrada
mensagens. Veja a descrição deste comando.

CONFIGURAÇÃO VARIÁVEIS

separadores de reboque
Esta opção informa quais caracteres são reconhecidos como separadores de trailer. Por padrão
só : é reconhecido como um separador de trailer, exceto que = é sempre aceito no
linha de comando para compatibilidade com outros comandos git.

O primeiro caractere fornecido por esta opção será o caractere padrão usado quando
outro separador não é especificado na configuração para este trailer.

Por exemplo, se o valor para esta opção for "% = $", então apenas as linhas usando o formato
com contendo %, = or $ e então os espaços serão considerados
trechos de um filme. E % será o separador padrão usado, então por padrão os trailers aparecerão
gostar: % (um sinal de por cento e um espaço aparecerá entre o token
e o valor).

reboque.onde
Esta opção informa onde um novo trailer será adicionado.

Pode ser fim, que é o padrão, início, depois ou antes.

Se for o fim, cada novo trailer aparecerá no final dos trailers existentes.

Se for o início, cada novo trailer aparecerá no início, em vez de no final, de
os trailers existentes.

Se for depois, cada novo trailer aparecerá logo após o último trailer com o
mesmo .

Se for antes, cada novo trailer aparecerá um pouco antes do primeiro trailer com
o mesmo .

reboque.se existir
Esta opção permite escolher qual ação será realizada quando houver
já pelo menos um trailer com o mesmo na mensagem.

Os valores válidos para esta opção são: addIfDifferentNeighbor (este é o padrão),
addIfDifferent, add, overwrite ou doNothing.

Com addIfDifferentNeighbor, um novo trailer será adicionado apenas se nenhum trailer com o
mesmo ( , ) par está acima ou abaixo da linha onde o novo trailer estará
adicionado.

Com addIfDifferent, um novo trailer será adicionado apenas se nenhum trailer com o mesmo
( , ) par já está na mensagem.

Com adicionar, um novo trailer será adicionado, mesmo se alguns trailers com o mesmo ( ,
) par já está na mensagem.

Com substituir, um trailer existente com o mesmo será excluído e o novo
trailer será adicionado. O trailer excluído será o mais próximo (com o mesmo
) ao local onde o novo será adicionado.

Com doNothing, nada será feito; ou seja, nenhum novo trailer será adicionado se houver
já um com o mesmo na mensagem.

trailer.ifmissing
Esta opção permite escolher qual ação será realizada quando houver
ainda não é nenhum trailer com o mesmo na mensagem.

Os valores válidos para esta opção são: add (este é o padrão) e doNothing.

Com adicionar, um novo trailer será adicionado.

Com doNothing, nada será feito.

reboque. .chave
Esta chave será usada em vez de no trailer. No final desta chave, um
separador pode aparecer e, em seguida, alguns caracteres de espaço. Por padrão, o único válido
separador é :, mas isso pode ser alterado usando a variável de configuração trailer.separators.

Se houver um separador, a chave será usada em vez de ambos e a
separador padrão ao adicionar o trailer.

reboque. .Onde
Esta opção assume os mesmos valores que o reboque.onde variável de configuração e isso
substitui o que é especificado por essa opção para trailers com o especificado .

reboque. .ifexist
Esta opção assume os mesmos valores que o reboque.se existir variável de configuração e isso
substitui o que é especificado por essa opção para trailers com o especificado .

reboque. .sentendo
Esta opção assume os mesmos valores que o trailer.ifmissing variável de configuração e
ele substitui o que é especificado por essa opção para trailers com o especificado .

reboque. .comando
Esta opção pode ser usada para especificar um comando shell que será chamado para
adicionar ou modificar automaticamente um trailer com o .

Quando esta opção é especificada, o comportamento é como se fosse um especial =
argumento foram adicionados no início da linha de comando, onde é considerado ser
a saída padrão do comando especificado com qualquer espaço em branco à esquerda e à direita
aparado.

Se o comando contém a string $ ARG, esta string será substituída pelo
parte de um trailer existente com o mesmo , se houver, antes que o comando seja
lançado.

Se algum = argumentos também são passados ​​na linha de comando, quando um
reboque. .comando está configurado, o comando também será executado para cada um dos
esses argumentos. E a parte desses argumentos, se houver, será usada para
substitua a string $ ARG no comando.

EXEMPLOS

· Configurar um assinar trailer com um Assinado por chave e, em seguida, adicione dois desses trailers
para uma mensagem:

$ git config trailer.sign.key "Assinado por"
$ gato msg.txt
sujeito

mensagem
$ cat msg.txt | git interpret-trailers --trailer 'sinal: Alice[email protegido]> sinal '--trailer': Bob[email protegido]>'
sujeito

mensagem

Assinado por: Alice[email protegido]>
Assinado por: Bob[email protegido]>

· Extraia o último commit como um patch e adicione um Cc e de um Revisados ​​pela trailer para ele:

$ git patch de formato -1
0001-foo.patch
$ git interpret-trailers --trailer 'Cc: Alice[email protegido]> '--trailer' Revisado por: Bob[email protegido]> '0001-foo.patch> 0001-bar.patch

· Configurar um assinar trailer com um comando para adicionar automaticamente um 'Signed-off-by:' com
as informações do autor apenas se já não houver 'assinado por:' e mostre como
obras:

$ git config trailer.sign.key "Assinado por:"
$ git config trailer.sign.ifmissing adicionar
$ git config trailer.sign.ifexists doNothing
$ git config trailer.sign.command 'echo "$ (git config user.name) <$ (git config user.email)>"'
$ git interpret-trailers <
> EOF

Assinado por: Bob[email protegido]>
$ git interpret-trailers <
> Assinado por: Alice[email protegido]>
> EOF

Assinado por: Alice[email protegido]>

· Configurar um fixo trailer com uma chave que contém um # e nenhum espaço depois disso
personagem e mostre como funciona:

$ git config trailer.separators ": #"
$ git config trailer.fix.key "Fix #"
$ echo "assunto" | git interpret-trailers --trailer fix = 42
sujeito

Corrigir #42

· Configurar um Vejo trailer com um comando para mostrar o assunto de um commit que é
relacionado e mostre como funciona:

$ git config trailer.see.key "Veja também:"
$ git config trailer.see.ifExiste "substituir"
$ git config trailer.see.if Faltando "doNothing"
$ git config trailer.see.command "git log -1 --oneline --format = \"% h (% s) \ "--abbrev-commit --abbrev = 14 \ $ ARG"
$ git interpret-trailers <
> assunto
>
> mensagem
>
> veja: CABEÇA ~ 2
> EOF
sujeito

mensagem

Consulte também: fe3187489d69c4 (assunto do commit relacionado)

· Configure um modelo de commit com alguns trailers com valores vazios (usando sed para mostrar
e mantenha os espaços finais no final dos trailers), em seguida, configure um commit-msg
gancho que usa git interpretar trailers para remover trailers com valores vazios e adicionar
a versão git reboque:

$ sed -e 's / Z $ / /'> commit_template.txt <
> *** assunto ***
>
> *** mensagem ***
>
> Correções: Z
> Cc: Z
> Revisado por: Z
> Assinado por: 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

Use git-interpret-trailers online usando serviços onworks.net