git-for-each-ref: en línea en la nube

PROGRAMA:

NOMBRE

git-for-each-ref: información de salida en cada ref

SINOPSIS

git para-cada-ref [--count = ] [--shell | --perl | --python | --tcl]
[(--sort = ) ...] [--format = ] [ ...]
[--punta-en ] [(--merged | --no-merged) [ ]]
[--contiene [ ]]

DESCRIPCIÓN

Itera sobre todos los árbitros que coinciden y mostrarlos de acuerdo con el dado ,
después de clasificarlos de acuerdo con el conjunto dado de . Si se da, deténgase después de
mostrando que muchas refs. Los valores interpolados en opcionalmente se puede citar como
literales de cadena en el lenguaje host especificado, lo que permite su evaluación directa en ese
idioma.

CAMPUS

De forma predeterminada, el comando muestra todas las referencias que coinciden . Esta opción lo detiene
después de mostrar que muchas refs.


Un nombre de campo para ordenar. Prefijo: para ordenar en orden descendente del valor. Cuando
sin especificar, se utiliza refname. Puede usar --sort = opción varias veces, en
cuyo caso la última clave se convierte en la clave principal.


Una cadena que interpola% (nombre de campo) del objeto apuntado por una referencia siendo
mostrado. Si el nombre del campo tiene como prefijo un asterisco (*) y la referencia apunta a una etiqueta
objeto, se utiliza el valor del campo en la etiqueta del objeto al que se refiere. Cuando no se especifica,
por defecto es% (nombre de objeto) SPC% (tipo de objeto) TAB% (nombre de referencia). También interpola %% a
% y% xx, donde xx son dígitos hexadecimales, se interpola a un carácter con código hexadecimal xx; por
ejemplo% 00 se interpola a \ 0 (NUL),% 09 a \ t (TAB) y% 0a a \ n (LF).

...
Si se dan uno o más patrones, solo se muestran las referencias que coinciden con al menos uno
patrón, ya sea usando partido fn(3) o literalmente, en el último caso coincidiendo completamente
o desde el principio hasta una barra.

--shell, --perl, --python, --tcl
Si se da, las cadenas que sustituyen a los marcadores de posición% (nombre de campo) se citan como cadena
literales adecuados para el idioma host especificado. Esto está destinado a producir un
scriptlet que se puede `evaluar` directamente.

--punta-en
Solo enumere las referencias que apuntan al objeto dado.

- fusionada [ ]
Solo enumere las referencias cuyas sugerencias sean accesibles desde la confirmación especificada (HEAD si no
especificado).

--no-fusionado [ ]
Solo enumere las referencias cuyas sugerencias no son accesibles desde la confirmación especificada (HEAD si no
especificado).

--contiene [ ]
Solo enumere las etiquetas que contienen la confirmación especificada (HEAD si no se especifica).

CAMPO NOMBRES

Se pueden utilizar varios valores de campos estructurados en objetos referenciados para interpolar
en la salida resultante, o como claves de clasificación.

Para todos los objetos, se pueden utilizar los siguientes nombres:

nombreref
El nombre de la referencia (la parte después de $ GIT_DIR /). Para un nombre corto no ambiguo del
ref append: corto. La opción core.warnAmbiguousRefs se utiliza para seleccionar el estricto
modo de abreviatura. Si tira = se adjunta, tiras ruta separada por barra
componentes del frente del nombre de referencia (por ejemplo,% (nombre de referencia: strip = 2) convierte refs / tags / foo
en foo. debe ser un número entero positivo. Si una referencia mostrada tiene menos componentes
que , el comando aborta con un error.

tipo de objeto
El tipo de objeto (blob, árbol, confirmación, etiqueta).

tamaño de objeto
El tamaño del objeto (el mismo que git archivo de gato -s informes).

nombre del objeto
El nombre del objeto (también conocido como SHA-1). Para una abreviatura no ambigua del nombre del objeto
añadir: corto.

río arriba
El nombre de una referencia local que se puede considerar "aguas arriba" de la referencia mostrada.
Respetos: abreviado de la misma manera que refname anterior. Además respeta: track to show
"[adelante N, detrás de M]" y: pista corta para mostrar la versión concisa: ">" (adelante), "<"
(detrás), "<>" (adelante y atrás) o "=" (sincronizado). No tiene ningún efecto si la referencia no
tener información de seguimiento asociada.

empuje
El nombre de una referencia local que representa la ubicación @ {push} de la referencia mostrada.
Respeta las opciones: corto,: pista y: pista corta como lo hace upstream. Produce un vacio
cadena si no se configura ninguna referencia @ {push}.

CABEZA
* si HEAD coincide con la referencia actual (la rama extraída), '' de lo contrario.

Color
Cambiar el color de salida. Seguido por : , donde los nombres se describen en
color.branch. *.

alinear
Alinee a la izquierda, en el medio o a la derecha el contenido entre% (alinear: ...) y% (final). los
"align:" va seguido de y en cualquier orden separado por una coma,
donde el es izquierdo, derecho o medio, por defecto es izquierdo y
es la longitud total del contenido con alineación. Si la longitud del contenido es superior a
el ancho, entonces no se realiza ninguna alineación. Si se usa con --cita todo en el medio
% (align: ...) y% (end) se citan, pero si están anidados, solo se realiza el nivel superior
cotización.

Además de lo anterior, para los objetos de confirmación y etiqueta, los nombres de los campos de encabezado (árbol,
padre, objeto, tipo y etiqueta) se pueden utilizar para especificar el valor en el campo de encabezado.

Para confirmar y etiquetar objetos, los campos creatordate y creator especiales corresponderán a
la fecha apropiada o la tupla de nombre-correo electrónico-fecha de los campos de confirmación o etiquetador
dependiendo del tipo de objeto. Están pensados ​​para trabajar en una combinación de anotaciones y
etiquetas ligeras.

Los campos que tienen la tupla nombre-correo electrónico-fecha como valor (autor, autor y etiquetador) se pueden
con el sufijo de nombre, correo electrónico y fecha para extraer el componente nombrado.

El mensaje completo en un objeto de confirmación y etiqueta es contenido. Su primera línea es
contenido: asunto, donde asunto es la concatenación de todas las líneas del mensaje de confirmación
a la primera línea en blanco. La siguiente línea es contenido: cuerpo, donde el cuerpo son todas las líneas
después de la primera línea en blanco. La firma GPG opcional es contenido: firma. La primera N
Las líneas del mensaje se obtienen usando contenido: líneas = N.

Para fines de clasificación, los campos con valores numéricos se ordenan en orden numérico (tamaño de objeto,
authordate, committerdate, creatordate, taggerdate). Todos los demás campos se utilizan para ordenar
su orden de valor en bytes.

También hay una opción para ordenar por versiones, esto se puede hacer usando el nombre del campo
version: refname o su alias v: refname.

En cualquier caso, un nombre de campo que hace referencia a un campo inaplicable al objeto referido por
la referencia no causa un error. En su lugar, devuelve una cadena vacía.

Como caso especial para los campos de tipo de fecha, puede especificar un formato para la fecha por
agregando: seguido del nombre del formato de fecha (vea los valores de la opción --date para :git-rev-
lista(1) toma).

EJEMPLOS

Un ejemplo que produce directamente texto formateado. Muestra las 3 confirmaciones etiquetadas más recientes:

#!/ Bin / sh

git para cada ref --count = 3 --sort = '- * fecha de autor' \
--format = 'De:% (* nombre de autor)% (* authoremail)
Asunto:% (* asunto)
Fecha:% (* fecha del autor)
Ref:% (* refname)

%(*cuerpo)
'' referencias / etiquetas '

Un ejemplo simple que muestra el uso de shell eval en la salida, demostrando el uso de
--cascarón. Enumere los prefijos de todas las cabezas:

#!/ Bin / sh

git para cada ref --shell --format = "ref =% (refname)" refs / heads | \
mientras lee la entrada
do
eval "$ entrada"
echo `dirname $ ref`
hecho

Un informe un poco más elaborado sobre etiquetas, que demuestra que el formato puede ser un
script:

#!/ Bin / sh

fmt = '
r =% (nombre de referencia)
t =% (* tipo de objeto)
T = $ {r # refs / tags /}

o =% (* nombre de objeto)
n =% (* nombre del autor)
e =% (* authoremail)
s =% (* sujeto)
d =% (* fecha del autor)
b =% (* cuerpo)

kind = Etiqueta
si prueba "z $ t" = z
luego
# podría ser una etiqueta ligera
t =% (tipo de objeto)
kind = "Etiqueta ligera"
o =% (nombre de objeto)
n =% (nombre del autor)
e =% (authoremail)
s =% (sujeto)
d =% (fecha de autor)
b =% (cuerpo)
fi
echo "$ kind $ T apunta a $ t objeto $ o"
si prueba "z $ t" = zcommit
luego
echo "La confirmación fue creada por $ n $ e
en $ d, y titulado

$s

Su mensaje se lee como:
"
echo "$ b" | sed -e "s / ^ / /"
echo
fi
'

eval = `git para-cada-ref --shell --format =" $ fmt "\
--sort = '* tipo de objeto' \
--sort = -taggerdate \
refs / tags`
eval "$ eval"

Use git-for-each-ref en línea usando los servicios de onworks.net