Les Sceaux Magiques

Tags et versionnage sémantique

Qu'est-ce qu'un tag ?

Un tag dans Git, c'est comme un sceau de cire posé sur un parchemin important. Contrairement aux branches qui bougent à chaque nouveau commit, un tag est fixe - il pointe toujours vers le même commit.

Les tags servent à marquer des moments importants dans l'historique d'un projet :

• La sortie d'une version stable (v1.0.0, v2.0.0)
• Un jalon important du projet (MVP, beta)
• Un point de référence pour revenir facilement à un état connu

Tags légers vs tags annotés

Git propose deux types de tags, comme deux types de sceaux.

Tag léger (lightweight)

Un tag léger est simplement un pointeur vers un commit. Pas de métadonnées supplémentaires - juste un nom associé à un commit.

git tag v0.1.0

C'est comme écrire un numéro au crayon dans la marge d'un parchemin. C'est rapide, mais il n'y a pas d'information supplémentaire.

Tag annoté (annotated)

Un tag annoté contient beaucoup plus d'informations :

• Le nom du tag
• La date de création
• Le nom de l'auteur
• Un message explicatif

git tag -a v1.0.0 -m "Première version stable du royaume"

C'est un vrai sceau de cire officiel : il porte la marque de l'Archiviste, la date, et une description de pourquoi ce moment est important.

Créer un tag

Tag léger

# Taguer le commit actuel (HEAD)
git tag v0.1.0

Tag annoté (recommandé)

# Taguer le commit actuel avec un message
git tag -a v1.0.0 -m "Première version stable"

L'option -a signifie "annotated" et -m permet d'ajouter un message, exactement comme pour git commit -m.

Taguer un commit passé

Tu peux aussi poser un sceau sur un commit ancien. Il suffit de préciser le hash du commit :

# Retrouver le hash du commit à taguer
git log --oneline

# Taguer ce commit
git tag -a v0.1.0 abc1234 -m "Fondation de la guilde"

C'est comme retourner dans les archives pour apposer un sceau sur un événement passé que personne n'avait pensé à marquer à l'époque.

Explorer les tags

Lister tous les tags

git tag

Affiche la liste de tous les tags, triés par ordre alphabétique.

Filtrer les tags par motif

# Tous les tags qui commencent par "v1."
git tag -l "v1.*"

# Tous les tags qui commencent par "v"
git tag -l "v*"

L'option -l (list) accepte un motif avec des caractères joker (*).

Voir les détails d'un tag

git show v1.0.0

Pour un tag annoté, git show affiche :

• L'auteur du tag et la date
• Le message du tag
• Les détails du commit associé (auteur, date, message, diff)

Pour un tag léger, git show affiche uniquement les détails du commit (pas d'information supplémentaire sur le tag lui-même).

Partager les tags

Par défaut, git push ne pousse pas les tags. Il faut les envoyer explicitement.

Pousser un tag spécifique

git push origin v1.0.0

Pousser tous les tags

git push origin --tags

Supprimer un tag

Supprimer un tag local

git tag -d v0.1.0

Le tag est supprimé localement. Si tu l'avais déjà poussé vers un dépôt distant, il faut aussi le supprimer là-bas :

git push origin --delete v0.1.0

Le versionnage sémantique

Les tags suivent souvent une convention appelée Semantic Versioning (SemVer). Le format est :

vMAJEUR.MINEUR.CORRECTIF

Exemples concrets

• v0.1.0 - première version de développement, pas encore stable
• v1.0.0 - première version stable, prête pour la production
• v1.0.1 - correction d'un bug dans la v1.0.0
• v1.1.0 - ajout d'une fonctionnalité à la v1.0
• v2.0.0 - refonte majeure, pas rétrocompatible

Quand poser un sceau ?

Voici les moments où tu devrais taguer :

• Release : chaque version livrée aux utilisateurs (v1.0.0, v1.1.0)
• Jalon : chaque étape importante du projet (v0.1.0 pour le MVP)
• Version stable : un point de référence fiable pour les autres développeurs
• Avant un changement risqué : pour pouvoir revenir facilement en cas de problème

Exercice pratique - Sceller les Chroniques du Royaume

Étape 1 - Créer le dépôt et la fondation de la guilde

mkdir sceaux-magiques
cd sceaux-magiques
git init -b main

Crée le premier parchemin et fais le premier commit :

echo "# Chroniques du Royaume" > chroniques.txt
echo "" >> chroniques.txt
echo "An 1 - La guilde des Archivistes est fondee." >> chroniques.txt
git add chroniques.txt
git commit -m "Fonder la guilde des Archivistes"

Pose un tag léger sur ce moment fondateur :

git tag v0.1.0

Étape 2 - Développer le royaume

echo "An 2 - Les premiers apprentis rejoignent la guilde." >> chroniques.txt
git add chroniques.txt
git commit -m "Accueillir les premiers apprentis"

echo "An 3 - La guilde explore les terres du Nord." >> chroniques.txt
git add chroniques.txt
git commit -m "Explorer les terres du Nord"

Étape 3 - La première grande victoire

echo "An 4 - La guilde remporte la bataille de Fort-Givre." >> chroniques.txt
git add chroniques.txt
git commit -m "Remporter la bataille de Fort-Givre"

Pose un tag annoté pour marquer cette victoire majeure :

git tag -a v1.0.0 -m "Premiere grande victoire - Bataille de Fort-Givre"

Étape 4 - La réparation après le siège

echo "An 5 - Le siege de la Citadelle cause de lourds degats." >> chroniques.txt
git add chroniques.txt
git commit -m "Subir le siege de la Citadelle"

echo "An 6 - Les murailles sont reconstruites plus solides." >> chroniques.txt
git add chroniques.txt
git commit -m "Reconstruire les murailles de la Citadelle"

Pose un tag annoté pour marquer la réparation :

git tag -a v1.0.1 -m "Reparation apres le siege - Murailles reconstruites"

Étape 5 - Explorer tes sceaux

Liste tous les tags :

git tag

Filtre les tags de la version 1 :

git tag -l "v1.*"

Inspecte un tag annoté :

git show v1.0.0

Compare avec un tag léger :

git show v0.1.0

Observe la différence : le tag annoté affiche l'auteur, la date et le message du tag, alors que le tag léger montre directement le commit.

Étape 6 - Lancer la vérification

bash verifier.sh

.\verifier.ps1

Récapitulatif des commandes