TP GIT1 – Mon premier projet sous git

Durée : 1 h, en autonomie. Objectif : refaire seul, sur un projet à vous, tout ce que nous avons vu ce matin, et finir avec un dépôt poussé sur GitHub sous le nom exact git-homework. Rien n'est noté ; en revanche c'est dans ce dépôt que vous déposerez le bonus learngitbranching, il faut donc qu'il existe.

Deux réflexes pour toute la séance : git status avant et après chaque commande, et git log --oneline --graph --all dès qu'une branche entre en jeu. Chaque étape se termine par une ligne « Vérifiez » qui vous dit ce que vous devez voir. Si ce n'est pas le cas, ne passez pas à la suite : relisez ce que git a répondu, il vous souffle presque toujours la commande qui répare.

1. Le projet

Choisissez un petit projet texte, sans dépendance : un carnet de recettes (un README.md et un dossier recettes/ avec un fichier Markdown par recette) ou un mini-script Python (main.py, un README.md, un fichier de données). Le contenu importe peu ; ce sont les commits qui comptent.

mkdir git-homework && cd git-homework
git init -b main

Créez le README.md (titre, une phrase), puis votre premier commit.

Vérifiez : git log --oneline montre exactement un commit ; git status dit nothing to commit, working tree clean.

2. Cinq commits propres

Faites grandir le projet en 4 ou 5 commits supplémentaires, un par idée : une recette, puis une deuxième, puis une correction, puis un sommaire dans le README… Chaque message commence par un verbe et décrit ce que le commit apporte (« Ajoute la recette des crêpes », pas « update »). Regardez au moins une fois git diff avant git add, et git diff --staged avant git commit.

Au passage, faites l'un des commits en n'ajoutant qu'un des deux fichiers que vous avez modifiés : c'est tout l'intérêt de l'index.

Vérifiez : git log --oneline liste 5 ou 6 commits, le plus récent en haut ; git log --stat -1 montre les fichiers du dernier.

3. .gitignore

Produisez de quoi ne pas versionner : un brouillon.tmp, et un dossier __pycache__/ avec un fichier dedans (mkdir __pycache__ && touch __pycache__/main.cpython-313.pyc, ou lancez vraiment votre script s'il importe un module à vous). git status doit les montrer en ??. Écrivez un .gitignore qui les exclut (un motif par ligne : __pycache__/, *.tmp), puis commitez le .gitignore lui-même.

Vérifiez : git status est propre alors que le fichier ignoré est toujours sur le disque (ls).

4. Une branche, un merge fast-forward

git switch -c garniture

Sur cette branche, un ou deux commits (une section « Garnitures » dans une recette, une fonction de plus dans le script). Revenez sur main, constatez que vos modifications ne sont plus là, puis fusionnez :

git switch main
git merge garniture

Vérifiez : git a affiché Fast-forward ; git log --oneline --graph --all est une ligne droite, main et garniture pointent sur le même commit. Supprimez ensuite la branche : git branch -d garniture.

5. Une seconde branche, un conflit, une résolution

Créez cuisson (ou ce que vous voulez). Sur cette branche, modifiez une ligne précise d'un fichier (par ex. le temps de cuisson) et commitez. Revenez sur main, modifiez la même ligne autrement, commitez. Puis :

git merge cuisson

Git annonce CONFLICT (content). Ouvrez le fichier, trouvez les marqueurs <<<<<<<, =======, >>>>>>>, gardez la version que vous voulez (ou une combinaison), supprimez les trois marqueurs, puis git add <fichier> et git commit (gardez le message proposé).

Vérifiez : git log --oneline --graph montre un commit de fusion à deux parents (* Merge branch 'cuisson' avec les deux traits |\) ; grep -r '<<<<<<<' . ne trouve rien.

6. Annuler un commit avec revert

Choisissez un commit du milieu de l'historique (pas le merge) dont la modification est simple, par ex. la « correction » de l'étape 2, et annulez-la proprement :

git revert <hash>

Vérifiez : un nouveau commit Revert "…" est en haut de git log --oneline ; le fichier est revenu à son contenu d'avant, et l'ancien commit est toujours dans l'historique.

7. Perdre un commit, le retrouver avec reflog

Notez le hash du commit en haut de git log --oneline. Puis, exprès :

git reset --hard HEAD~1
git log --oneline          # le commit a disparu
git reflog                 # …mais pas de git

Retrouvez-le dans le reflog et ramenez main dessus : git reset --hard HEAD@{1} (ou avec le hash noté).

Vérifiez : git log --oneline est redevenu identique à ce qu'il était avant le reset ; git status est propre.

8. Pousser sur GitHub sous le nom git-homework

1. Sur GitHub, New repository : nom exact git-homework, public ou privé au choix, sans cocher « Add a README » ni .gitignore (le projet existe déjà). Si vous le mettez privé, ajoutez raphaelpra en collaborateur (Settings → Collaborators), exactement comme pour pe-homework.
2. Dans votre terminal, à la racine du projet :

   git remote add origin git@github.com:VOTRE-LOGIN/git-homework.git
   git push -u origin main
   

3. Rechargez la page GitHub : vos fichiers et le nombre de commits doivent y être.

Vérifiez, et c'est la vraie vérification : un clone frais, ailleurs, reproduit votre historique.

cd /tmp
git clone git@github.com:VOTRE-LOGIN/git-homework.git verif
cd verif && git log --oneline --graph

Vous devez y retrouver vos commits, le merge à deux parents, le Revert. Si git push est refusé (rejected), c'est presque toujours que le dépôt GitHub a été créé avec un README : le plus simple est de le supprimer et de le recréer vide.

Ce que je regarderai

Rien n'est noté sur ce TP. Je passerai simplement, dans la semaine, sur les dépôts git-homework pour vérifier qu'ils existent et que l'historique ressemble à celui demandé : plusieurs commits aux messages lisibles, un .gitignore, un merge fast-forward (invisible, c'est normal) et un merge commit à deux parents issu d'un conflit, un Revert. Si le vôtre n'y est pas, poussez-le quand vous pourrez : c'est à la racine de ce dépôt que vous commiterez solvedMap.json pour le bonus learngitbranching, avant le mercredi 21 octobre 2026, 18 h.

Pour toute question, vous pouvez me contacter par email : raphael@imagine-app.fr.