Nom :
Prénom :

Suivre les consignes de ce document

Faire les modifications indiquées directement dans ce même document en suivant les indications.

Faire un commit après avoir saisi votre nom et prénom *(et surtout ne pas le "pousser" vers GitHub)
Annuler ce commit avec VScode (⇧⌘P Git: Undo Last Commit)
Effacer votre prénom et refaire le commit (toujours sans le pousser).
Resaisir votre prénom et amender le commit (⇧⌘P Git: Commit All (Amend))
Cochez cette checkbox en plaçant un "X" entre les deux [ ] en début de ligne.
Faire un commit avec le message "test commit et push"
Faire un push du commit sur Github.

Principe du TP

Cochez les checkboxes quand demandé et/ou répondez directement dans ce document.
Suivre les indications sur les commits et autres manipulations.

L'historique git de vos commits sera la preuve que vous avez fait le TP.

Gitignore

Le fichier .gitignore sert à indiquer à Git les fichiers qu'il doit ignorer (c.-à-d. qu'il ne gardera pas l'historique de leurs modifications).

génération automatique du fichier `.gitignore`

Installez l'extension ".gitignore Generator" .
L'utiliser (Shift+CMD+P Generate .gitignore File).
- Faire un fichier .gitignore en sélectionnant :
  - windows
  - macos
  - visualstudiocode
- Si extension ne fonctionne pas :
  - Faire vous-même un nouveau fichier .gitignore à la racine.
  - Sélectionner les mêmes choix sur le site gitignore.io
  - Copier le contenu généré dans votre fichier .gitignore
cocher et faire commit "ajout .gitignore"

ajout manuel à `.gitignore`

Faire un fichier /public/video/a-ignorer.txt
Ajouter en fin de fichier .gitignore la ligne suivante :
- /public/video
cocher et commit "ajout dossier à .gitignore"
Synchroniser les commits avec Github
- constater que le fichier /public/video/a-ignorer.txt n'a pas été publié sur Github

Conflits

Depuis le site Github (le dépôt "distant"), utiliser le bouton éditer ✏ pour cocher cette case. Avec "édit depuis Github", comme message de commit.
Cochez cette case depuis VSCode (le dépôt sur votre PC). Faire un commit "édit local"
Demandez à VSCode de synchroniser.
- Cela doit échouer.
- Faire Shift+CMD+P Git: Pull (rebase)
  - Dans ce cas, faire "accept both change" et éditer pour garder les deux cases cochées.
  - Valider le changement du commit
  - Finir "rebase".
Faire un "push" vers Github.

Branches

Faire une branche

Faire une branche en cliquant en bas-à-gauche sur VSCode ; la nommer (en adaptant) "votre-pseudo/test-branche"
- VSCode vous place automatiquement dans la nouvelle branche.
Cochez et commit : "1re commit dans branche"
Puis cochez et commit "2nd commit dans branche"
Regardez la liste des commits dans le volet Chronologie en bas de explorateur de VSCode

Changer de branche

Retourner à la branche "master" avec le bouton en bas à gauche
- Regardez les deux checkboxes au-dessus, elles ne sont pas cochées (important: les laisser ainsi) .
- Cochez et commit : "commit dans master à rebaser dans branche"
Regardez la liste des commits
- Vous ne voyez pas les commits faits dans la branche
Retourner à la branche "????/test-branche"

"Rebaser" une branche

Utiliser la commande Shift+CMD+P Git: rebaser la branche
- Choisir la branche "Master"
  - Si Conflit :
    - Accepter la version courante dans l'éditeur
    - Valider la résolution de conflit dans le volet "Changements rebase" du panneau "Contrôle de code source"

"Merger" une branche

Retourner à la branche "Master"
Faire la commande Shift+CMD+P Git: Merge Branch
- Sélectionner la branche "????/test-branche"
Regardez la liste des commits
- Vous voyez les commits faits dans la branche !
  - Et plus haut dans ce document les checkboxes correspondantes sont cochées
Poussez les commits vers Github

"Amend", Réordonner et "squash" les commits.

Pour ces étapes on va utiliser Github Destop.

Lancer Github Desktop et ouvrir la copie locale de ce dépôt avec Github Desktop en le faisant glisser sur son panneau d'accueil.
Sélectionner la branche "????/test-branche"
On peut modifier l'historique des commits tant qu'ils n'ont pas été "poussés" vers le dépôt central (origin).
Modifier l'historique des commits déjà publiés peut causer de gros problèmes. Donc faire ses travaux dans une branche est plus sûr.

Documentation "amend" et autres manipulations...

Consignes

Décrire ce que vous faites en éditant ce document sur le modèle des indications que j'ai données avant.

Exemple :

A vous de faire

Plusieurs commits
"amend" du derniers commit
Réordonnez des commits
"squash" des commits ensembles

Éditez ici

Remonter dans le temps pour trouver un "bug"

décochez cette case et commit : "le bug"
message à modifier plus tard
cochez et commit : "après bug 1"
cochez et commit : "après bug 2"
cochez et commit : "après bug 3"
Dans le terminal, répéter la commande :
- git checkout head~1
- Jusqu'à ce que la case du "bug" soit de nouveau cochée (c.-à-d. remonter jusqu'avant le commit du bug)
- Ne jamais changer le code quand on utilise "checkout" ainsi.
Faire une branche "correction-bug", pour pouvoir changer et tester le code sans risque.
- Remplacer le message à modifier plus haut par : Bug corrigé
- Faire un commit : "Bug corrigé"
- En vrai, on testerait maintenant si notre code est "sans bug".
Faire un cherry pick de ce commit vers la branche "master".
- Résoudre le conflit en prenant "incoming change" (le bug corrigé) dans VSCode.

Mettre des changements de côté (stash)

Certaines actions ne peuvent être faites s'il existe des changements "non commités".

cochez cette case sans faire de commit !
Essayez de changer de branche :
- Vous ne pouvez pas
- Choisir "Faire un stash et extraire"
- Ou bien dans le terminal : git stash
  - Suivit du changement de branche
- cochez et commit "Dans branche"
Retourner à la branche "master"
Faire Shift+CMD+P Git: Pop latest stash
- Ou bien dans le terminal : git stash pop

Vous devez retrouvez votre changement "non commité" : faire le commit "test stash"

Preuve que vous avez bien fait le travail demandé :

Dans le terminal :
- git reflog show > reflog.txt
Faire un commit 'ajout copie du reflog"

ppierre/tp-git