L'Arbre des Possibles

Introduction

« Apprenti, jusqu'à présent, tu as travaillé sur une seule ligne du temps - une chronique unique, linéaire, où chaque événement suit le précédent. Mais les grands Archivistes savent quelque chose que les novices ignorent : l'histoire n'a pas qu'un seul chemin possible. Regarde cet arbre. Chaque branche représente une timeline parallèle - un futur possible pour le royaume. On peut explorer ces branches, y consigner des événements, et décider plus tard laquelle deviendra la chronique officielle. C'est le pouvoir des branches Git. »

Qu'est-ce qu'une branche ?

Jusqu'ici, tous tes commits se sont enchaînés sur une seule branche : main (anciennement "master"). C'est la chronique officielle - la timeline principale du projet.

Pourquoi utiliser des branches ?

• Expérimenter sans risque : tu testes une idée sur une branche. Si ça marche, tu la gardes. Sinon, tu la supprimes.
• Travailler en parallèle : pendant qu'un collègue travaille sur une fonctionnalité, tu travailles sur une autre, chacun sur sa branche.
• Garder main propre : la branche principale ne contient que du code validé et testé.

Voir les branches existantes

Pour lister toutes les branches de ton dépôt :

git branch

La branche courante est marquée d'une étoile * et apparaît en vert :

* main

Pour l'instant, tu n'as qu'une seule branche. Ça va changer.

Créer une nouvelle branche

Pour créer une branche sans y basculer :

git branch <nom>

Exemple :

git branch expedition-nord

Cela crée une branche expedition-nord qui pointe vers le même commit que ta branche actuelle. Mais tu es toujours sur main - tu n'as pas changé de timeline.

Vérifie :

git branch

  expedition-nord
* main

L'étoile est toujours sur main.

Basculer sur une branche

La commande moderne : git switch

git switch expedition-nord

C'est la méthode recommandée depuis Git 2.23. Simple, claire, sans ambiguïté.

L'ancienne méthode : git checkout

git checkout expedition-nord

Tu verras git checkout dans beaucoup de tutoriels et de projets existants. Ça fonctionne, mais git switch est plus explicite car git checkout fait aussi d'autres choses (restaurer des fichiers, par exemple).

Créer et basculer en une seule commande

Tu peux combiner la création et le basculement :

git switch -c nouvelle-branche

Ou avec l'ancienne syntaxe :

git checkout -b nouvelle-branche

HEAD - Le marqueur de position

HEAD est un pointeur spécial qui indique où tu te trouves dans l'historique. Plus précisément, HEAD pointe vers la branche courante, qui elle-même pointe vers un commit.

HEAD -> main -> commit C3
         expedition-nord -> commit C3

Quand tu fais git switch expedition-nord :

         main -> commit C3
HEAD -> expedition-nord -> commit C3

Et quand tu fais un nouveau commit sur expedition-nord :

         main -> commit C3
HEAD -> expedition-nord -> commit C4

Supprimer une branche

Suppression sécurisée

git branch -d nom-de-la-branche

L'option -d (minuscule) supprime la branche uniquement si elle a été fusionnée. C'est une sécurité : Git refuse de supprimer une branche qui contient du travail non intégré.

Suppression forcée

git branch -D nom-de-la-branche

Exercice pratique - Les Chroniques parallèles

Étape 1 - Créer le dépôt

Crée un nouveau dossier et initialise un dépôt Git :

mkdir chroniques-paralleles
cd chroniques-paralleles
git init -b main

Étape 2 - Premier commit sur main

Crée un fichier de base et fais ton premier commit :

echo "# Chroniques du Royaume" > chroniques.md
git add chroniques.md
git commit -m "Créer le registre des chroniques du royaume"

Étape 3 - Créer la branche expedition-nord

git branch expedition-nord

Étape 4 - Basculer sur expedition-nord

git switch expedition-nord

Vérifie que tu es bien sur la bonne branche :

git branch

Tu devrais voir l'étoile sur expedition-nord.

Étape 5 - Commiter sur expedition-nord

Crée un fichier et commite-le :

echo "Jour 1 : L'expédition quitte la cité vers les Montagnes de Givre." > nord.md
git add nord.md
git commit -m "Ajouter le journal de l'expédition nord"

Étape 6 - Revenir sur main

git switch main

Étape 7 - Créer et basculer sur expedition-sud

Cette fois, combine les deux en une seule commande :

git switch -c expedition-sud

Étape 8 - Commiter sur expedition-sud

echo "Jour 1 : L'expédition s'enfonce dans la Forêt d'Émeraude." > sud.md
git add sud.md
git commit -m "Ajouter le journal de l'expédition sud"

Étape 9 - Lister toutes les branches

git branch

Tu devrais voir trois branches : expedition-nord, expedition-sud (avec l'étoile), et main.

Étape 10 - Vérifier

Lance le script de vérification pour valider ta quête :

Bash (Linux / macOS / Git Bash sur Windows) :

bash verifier.sh

PowerShell (Windows) :

.\verifier.ps1

Le script vérifie :

1. Tu es dans un dépôt Git
2. La branche expedition-nord existe
3. La branche expedition-sud existe
4. La branche expedition-nord contient au moins un commit propre
5. La branche expedition-sud contient au moins un commit propre
6. Il y a au moins 3 branches au total
7. Tu es de retour sur la branche main

Récapitulatif des commandes