Comando git describe
Operaciones básicas de Gitgit describeEl comando se usa para generar una cadena legible que describe la confirmación actual basándose en el sistema de etiquetas de Git.
git describeEste comando se usa comúnmente para generar números de versión, ayudar a identificar confirmaciones específicas y poder usarse al construir, publicar o rastrear versiones específicas.
Sintaxis básica
git describe [<options>] [<commit>]
<commit>: especifica la confirmación a describir. Por defecto, es la confirmación actual.<options>: Opciones para personalizar el formato de salida o el comportamiento.
Opciones y usos comunes:
| Opción | Descripción | Ejemplo de uso |
|---|---|---|
--tags | Usa todas las etiquetas (incluidas las etiquetas ligeras) para generar la descripción. Por defecto,git describesolo se consideran las etiquetas anotadas. | git describe --tags |
--abbrev=<n> | Establece la longitud mínima del hash de confirmación que se mostrará en<n>caracteres. | git describe --abbrev=8 |
--long | Fuerza la visualización de la descripción en formato largo, incluidos el hash de la confirmación y el número de confirmaciones desde la etiqueta. | git describe --long |
--exact-match | Devuelve solo el nombre de la etiqueta cuando la confirmación actual coincide exactamente con la etiqueta. | git describe --exact-match |
--dirty | Si el directorio de trabajo tiene cambios (cambios sin confirmar), agrega a la descripción el-dirtysufijo. | git describe --dirty |
--match=<pattern> | Solo utiliza etiquetas que coincidan con el patrón especificado para la descripción. | git describe --match "v1.*" |
--candidates=<n> | Limita el número de etiquetas consideradas para la descripción; el valor predeterminado es 10. | git describe --candidates=5 |
--always | Muestra el hash de la confirmación incluso si no se encuentra ninguna etiqueta. | git describe --always |
Usos comunes
1. Describir la confirmación actual
Genera una cadena de descripción basada en la etiqueta más reciente:
git describe
Salida de ejemplo:
v1.2-15-g2414721
La salida aquí indica que la confirmación actual está a 15 confirmaciones de la etiqueta más reciente v1.2, y el hash de la confirmación actual es 2414721.
2. Usar todas las etiquetas para la descripción
Incluye todas las etiquetas (ligeras y anotadas) para generar la descripción:
git describe --tags
3. Mostrar la descripción en formato largo
Muestra la descripción en formato largo, incluidos el hash y el número de confirmaciones desde la etiqueta:
git describe --long
4. Devolver solo el nombre de la etiqueta cuando la confirmación coincida exactamente
Si la confirmación actual coincide exactamente con una etiqueta, devuelve solo el nombre de la etiqueta:
git describe --exact-match
5. Agregar el sufijo -dirty
Si el directorio de trabajo tiene cambios sin confirmar, agrega el sufijo -dirty a la descripción:
git describe --dirty
6. Usar solo etiquetas que coincidan con el patrón
Utiliza etiquetas que coincidan con el patrón especificado para la descripción:
git describe --match "v1.*"
7. Mostrar el hash de la confirmación incluso si no se encuentra ninguna etiqueta
Muestra el hash de la confirmación actual incluso cuando no hay etiquetas:
git describe --always
Otras extensiones