Comment vérifier si un dépôt Git possède des étiquettes (tags)

Introduction

Dans ce laboratoire (lab), vous apprendrez à vérifier si un dépôt Git contient des étiquettes (tags). Les étiquettes sont des marqueurs importants dans l'historique d'un projet, souvent utilisées pour désigner des points de publication spécifiques. Nous explorerons deux méthodes principales pour lister les étiquettes existantes : la commande simple git tag et la commande plus détaillée git show-ref --tags, en comprenant ce que leur sortie (ou son absence) signifie dans un dépôt sans étiquettes.

Grâce à une pratique pratiques, vous verrez comment ces commandes se comportent dans un dépôt nouvellement initialisé et vous comprendrez leurs utilisations respectives pour identifier rapidement des étapes clés ou pour une inspection plus détaillée des références. Ce laboratoire fournit les connaissances de base pour travailler avec les étiquettes dans vos projets Git.

Skills Graph

Exécuter git tag pour lister les étiquettes (tags)

Dans cette étape, nous apprendrons à lister les étiquettes existantes dans un dépôt Git. Les étiquettes sont comme des étapes clés dans l'historique de votre projet, souvent utilisées pour marquer des points de publication (par exemple, v1.0, v2.0).

Tout d'abord, assurons - nous que nous sommes dans le répertoire de notre projet. Ouvrez votre terminal et tapez :

cd ~/project/my-time-machine

Maintenant, pour voir s'il y a des étiquettes dans notre dépôt, nous utilisons la commande git tag :

git tag

Comme il s'agit d'un nouveau dépôt et que nous n'avons pas encore créé d'étiquettes, vous ne devriez voir aucune sortie. C'est normal ! La commande liste simplement les étiquettes existantes. S'il y avait des étiquettes, elles seraient listées ici, généralement par ordre alphabétique.

Comprendre comment lister les étiquettes est la première étape pour travailler avec elles. Cela vous permet de voir rapidement les versions importantes ou les étapes clés qui ont été marquées dans l'historique de votre projet. Dans les étapes suivantes, nous apprendrons à créer et à utiliser ces étiquettes.

Utiliser git show-ref --tags

Dans cette étape, nous explorerons une autre façon d'afficher les étiquettes (tags), qui fournit des informations plus détaillées. La commande git show-ref --tags liste les références dans le répertoire .git qui pointent vers des étiquettes.

Assurez - vous que vous êtes toujours dans le répertoire de votre projet :

cd ~/project/my-time-machine

Maintenant, exécutez la commande :

git show-ref --tags

Comme nous n'avons pas encore créé d'étiquettes, cette commande ne produira également aucune sortie. C'est parce qu'il n'y a pas de références dans le répertoire .git qui pointent vers des étiquettes.

La commande git show-ref est une commande de bas niveau qui affiche les références brutes (comme les branches et les étiquettes) et le commit vers lequel elles pointent. L'option --tags filtre cette sortie pour n'afficher que les références d'étiquettes. Alors que git tag est généralement suffisant pour lister les étiquettes, git show-ref --tags peut être utile pour la création de scripts ou le débogage, car elle affiche le hachage complet du commit vers lequel chaque étiquette pointe.

Dans l'étape suivante, nous créerons une étiquette puis nous réutiliserons ces commandes pour voir comment la sortie change. Cela vous aidera à mieux comprendre comment Git suit les étiquettes.

Tester les dépôts sans étiquettes (tags)

Dans cette étape, nous confirmerons que notre dépôt n'a actuellement aucune étiquette en utilisant les deux commandes que nous avons apprises. Cela renforce le concept qu'un dépôt nouvellement initialisé commence sans aucune étiquette.

Assurez - vous que vous êtes dans le bon répertoire :

cd ~/project/my-time-machine

Tout d'abord, exécutez à nouveau git tag :

git tag

Comme prévu, il ne devrait y avoir aucune sortie, confirmant qu'aucune étiquette n'existe.

Ensuite, exécutez git show - ref --tags :

git show-ref --tags

Encore une fois, il ne devrait y avoir aucune sortie, car il n'y a pas de références d'étiquettes dans le dépôt.

Cette étape sert de référence. Nous avons confirmé qu'un nouveau dépôt Git ne possède pas automatiquement d'étiquettes. Cela signifie que toutes les étiquettes que vous voyez dans l'historique d'un projet ont été explicitement créées par quelqu'un. Dans les laboratoires suivants, nous apprendrons à créer nos propres étiquettes pour marquer les points importants du développement de notre projet.

Résumé

Dans ce laboratoire, nous avons appris deux méthodes principales pour vérifier l'existence d'étiquettes (tags) dans un dépôt Git. La première méthode, en utilisant la commande git tag, fournit une liste simple de toutes les étiquettes existantes. Lorsqu'elle est exécutée dans un dépôt sans étiquettes, elle ne produit aucune sortie. La deuxième méthode, git show - ref --tags, offre une vue plus détaillée en listant les références dans le répertoire .git qui pointent vers des étiquettes, ainsi que le hachage du commit qu'elles référencent. Tout comme git tag, cette commande ne produit également aucune sortie dans un dépôt sans étiquettes. Les deux commandes sont des outils précieux pour comprendre l'état des étiquettes d'un projet Git, git tag étant adaptée pour des vérifications rapides et git show - ref --tags offrant plus de détails pour la création de scripts ou le débogage.