git-interpret-trailers: en línea en la nube

PROGRAMA:

NOMBRE

git-interpret-trailers: ayuda a agregar información estructurada en los mensajes de confirmación

SINOPSIS

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

DESCRIPCIÓN

Ayuda para agregar remolques líneas, que se parecen a los encabezados de correo electrónico RFC 822, al final de la
de lo contrario, forma parte libre de un mensaje de confirmación.

Este comando lee algunos parches o confirma mensajes desde el argumentos o el
entrada estándar si no está especificado. Entonces este comando aplica los argumentos pasados
usando la opción --trailer, si la hay, en la parte del mensaje de confirmación de cada archivo de entrada. los
El resultado se emite en la salida estándar.

Algunas variables de configuración controlan la forma en que los argumentos --trailer se aplican a cada
mensaje de confirmación y la forma en que se cambia cualquier tráiler existente en el mensaje de confirmación. Ellos
también permiten agregar automáticamente algunos avances.

Por defecto, un = or : argumento dado usando --trailer será
se adjunta después de los remolques existentes solo si el último remolque tiene un ( ,
) par (o si no hay un tráiler existente). los y las partes serán
recortado para eliminar los espacios en blanco iniciales y finales, y el resultado recortado y
aparecerá en el mensaje así:

token: valor

Esto significa que el recortado y estará separado por ':' (dos puntos
seguido de un espacio).

Por defecto, el nuevo tráiler aparecerá al final de todos los tráileres existentes. Sí hay
no hay un tráiler existente, el nuevo tráiler aparecerá después del mensaje de confirmación que forma parte del
salida y, si no hay una línea con solo espacios al final de la parte del mensaje de confirmación,
se agregará una línea en blanco antes del nuevo avance.

Los remolques existentes se extraen del mensaje de entrada buscando un grupo de uno o
más líneas que contienen dos puntos (por defecto), donde el grupo está precedido por uno o más
líneas vacías (o solo espacios en blanco). El grupo debe estar al final del mensaje o estar
las últimas líneas que no son espacios en blanco antes de una línea que comienza con . . . . Estos tres signos negativos
inicie la parte del parche del mensaje.

Al leer avances, puede haber espacios en blanco antes y después del token, el separador
y el valor. También puede haber espacios en blanco dentro del token y el valor.

Tenga en cuenta que remolques no siguen y no están destinados a seguir muchas reglas para RFC 822
encabezados. Por ejemplo, no siguen las reglas de plegado de líneas, las reglas de codificación y
probablemente muchas otras reglas.

CAMPUS

--recortar-vacío
Si el parte de cualquier tráiler contiene solo espacios en blanco, todo el tráiler será
eliminado del mensaje resultante. Esto se aplica tanto a los remolques existentes como a los nuevos.
remolques

--remolque [(= | :) ]
Especifique un ( , ) par que debe aplicarse como avance a la entrada
mensajes. Vea la descripción de este comando.

CONFIGURACIÓN VARIABLES

separadores de remolques
Esta opción indica qué caracteres se reconocen como separadores de avance. Por defecto
, solamente : se reconoce como un separador de remolque, excepto que = siempre se acepta en el
línea de comando para compatibilidad con otros comandos de git.

El primer carácter dado por esta opción será el carácter predeterminado utilizado cuando
no se especifica otro separador en la configuración de este tráiler.

Por ejemplo, si el valor de esta opción es "% = $", solo las líneas que usan el formato
con conteniendo %, = or $ y luego se considerarán espacios
remolques. Y % será el separador predeterminado utilizado, por lo que aparecerán los remolques predeterminados
me gusta: % (un signo de porcentaje y un espacio aparecerán entre el token
y el valor).

remolque donde
Esta opción indica dónde se agregará un nuevo avance.

Esto puede ser final, que es el predeterminado, inicio, después o antes.

Si es final, entonces cada nuevo tráiler aparecerá al final de los tráileres existentes.

Si es inicio, entonces cada nuevo avance aparecerá al principio, en lugar del final, de
los remolques existentes.

Si es posterior, cada nuevo avance aparecerá justo después del último avance con el
mismo .

Si es antes, cada nuevo tráiler aparecerá justo antes del primer tráiler con
lo mismo .

remolque.ifexists
Esta opción permite elegir qué acción se realizará cuando haya
ya al menos un tráiler con el mismo en el mensaje.

Los valores válidos para esta opción son: addIfDifferentNeighbor (este es el predeterminado),
addIfDifferent, agregar, sobrescribir o no hacer nada.

Con addIfDifferentNeighbor, se agregará un nuevo avance solo si no hay un avance con el
mismo ( , ) el par está por encima o por debajo de la línea donde estará el nuevo tráiler.
añadido.

Con addIfDifferent, se agregará un nuevo avance solo si no hay un avance con el mismo
( , ) par ya está en el mensaje.

Con add, se agregará un nuevo tráiler, incluso si algunos tráileres con el mismo ( ,
) par ya están en el mensaje.

Con reemplazo, un remolque existente con el mismo será eliminado y el nuevo
Se agregará el trailer. El tráiler eliminado será el más cercano (con el mismo
) al lugar donde se agregará el nuevo.

Con no hacer nada, no se hará nada; que no se agregará un nuevo avance si hay
ya uno con el mismo en el mensaje.

remolque.
Esta opción permite elegir qué acción se realizará cuando haya
todavía no hay ningún tráiler con el mismo en el mensaje.

Los valores válidos para esta opción son: agregar (este es el predeterminado) y no hacer nada.

Con agregar, se agregará un nuevo avance.

Con doNothing, no se hará nada.

remolque. .llave
Esta clave se utilizará en lugar de en el trailer. Al final de esta clave, un
puede aparecer un separador y luego algunos caracteres de espacio. Por defecto el único válido
el separador es :, pero esto se puede cambiar usando la variable de configuración trailer.separators.

Si hay un separador, entonces se utilizará la clave en lugar de ambas y el
separador predeterminado al agregar el avance.

remolque. .dónde
Esta opción toma los mismos valores que el remolque donde variable de configuración y
anula lo especificado por esa opción para los remolques con el especificado .

remolque. .si existe
Esta opción toma los mismos valores que el remolque.ifexist variable de configuración y
anula lo especificado por esa opción para los remolques con el especificado .

remolque. .ifmissing
Esta opción toma los mismos valores que el remolque. variable de configuración y
anula lo especificado por esa opción para los remolques con el especificado .

remolque. .mando
Esta opción se puede utilizar para especificar un comando de shell al que se llamará para
agregar o modificar automáticamente un tráiler con el especificado .

Cuando se especifica esta opción, el comportamiento es como si un especial =
Se agregaron argumentos al comienzo de la línea de comando, donde se toma para ser
la salida estándar del comando especificado con cualquier espacio en blanco inicial y final
cortado.

Si el comando contiene la cadena $ ARG, esta cadena se reemplazará con la
parte de un remolque existente con el mismo , si lo hay, antes de que el comando sea
puesto en marcha.

Si algun = Los argumentos también se pasan en la línea de comando, cuando un
remolque. .mando está configurado, el comando también se ejecutará para cada
estos argumentos. Y el parte de estos argumentos, si los hay, se utilizarán para
reemplace la cadena $ ARG en el comando.

EJEMPLOS

· Configurar un firmar remolque con un Firmado por clave, y luego agregue dos de estos avances
a un mensaje:

$ git config trailer.sign.key "Firmado por"
$ gato msj.txt
sujeto

mensaje
$ cat msg.txt | git interpret-trailers --trailer 'sign: Alice[email protected]> Signo '--trailer': Bob[email protected]>'
sujeto

mensaje

Firmado por: Alice[email protected]>
Firmado por: Bob[email protected]>

· Extraiga la última confirmación como parche y agregue un Cc y Revisado por tráiler a él:

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

· Configurar un firmar tráiler con un comando para agregar automáticamente un 'Firmado por:' con
la información del autor solo si no hay un 'Firmado por:' ya, y muestre cómo
obras:

$ git config trailer.sign.key "Firmado por:"
$ git config trailer.sign.ifmissing agregar
$ git config trailer.sign.ifexists no hacen nada
$ git config trailer.sign.command 'echo "$ (git config user.name) <$ (git config user.email)>"'
$ git interpretar-trailers <
> EOF

Firmado por: Bob[email protected]>
$ git interpretar-trailers <
> Firmado por: Alice[email protected]>
> EOF

Firmado por: Alice[email protected]>

· Configurar un reparar tráiler con una llave que contiene un # y no hay espacio después de esto
personaje y mostrar cómo funciona:

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

Arreglar #42

· Configurar un ver tráiler con un comando para mostrar el tema de una confirmación que es
relacionados y mostrar cómo funciona:

$ git config trailer.see.key "Véase también:"
$ git config trailer.see.ifExists "reemplazar"
$ git config trailer.see.if Falta "no hacer nada"
$ git config trailer.see.command "git log -1 --oneline --format = \"% h (% s) \ "--abbrev-commit --abbrev = 14 \ $ ARG"
$ git interpretar-trailers <
> tema
>
> mensaje
>
> ver: HEAD ~ 2
> EOF
sujeto

mensaje

Véase también: fe3187489d69c4 (sujeto de la confirmación relacionada)

· Configure una plantilla de confirmación con algunos avances con valores vacíos (usando sed para mostrar
y mantenga los espacios finales al final de los tráileres), luego configure un mensaje de confirmación
gancho que usa git interpretar-remolques para eliminar remolques con valores vacíos y agregar
a versión git remolque:

$ sed -e 's / Z $ / /'> commit_template.txt <
> *** asunto ***
>
> *** mensaje ***
>
> Correcciones: Z
> Cc: Z
> Revisado por: Z
> Firmado por: Z
> EOF
$ git config commit.template commit_template.txt
$ gato> .git / hooks / commit-msg <
> #!/ Bin / sh
> git interpret-trailers --trim-empty --trailer "git-version: \ $ (git describe)" "\ $ 1"> "\ $ 1.new"
> mv "\ $ 1.nuevo" "\ $ 1"
> EOF
$ chmod + x .git / hooks / commit-msg

Use git-interpret-trailers en línea usando los servicios de onworks.net