Cómo obtener una descripción de un commit con describe en Git

¿Qué es git describe y para qué se usa?

git describe toma el commit actual (o uno especificado) y lo describe utilizando la etiqueta más cercana en la línea de tiempo del proyecto. El resultado contiene la última etiqueta alcanzable, el número de commits desde esa etiqueta y los primeros caracteres del hash del commit actual.

Esta información es útil para entender la posición de un commit respecto a una versión etiquetada y para proporcionar un nombre de versión descriptivo que puede ser usado en scripts, reportes de errores o en versiones preliminares del software.

Ejemplos de uso de git describe

Obtener la descripción del commit actual

Si estás en una rama con etiquetas, este comando mostrará algo similar a: v1.2-4-g9c3d2f1, donde:

Describir un commit específico usando su SHA

Esto genera la descripción para el commit indicado por el hash.

Incluir solo etiquetas anotadas

Si solo quieres que git describe utilice etiquetas anotadas para la descripción:

Esto es útil cuando tienes tanto etiquetas ligeras como anotadas en el repositorio.

Mostrar siempre la versión completa

Para asegurar que se incluya el número de commits y el hash en la salida, incluso si estás en el commit de la etiqueta:

Esto garantiza que git describe devuelva una descripción legible en cualquier situación.

Referencia oficial

Para más información sobre git describe, consulta la documentación oficial de Git.