====== Utiliser Git pour pousser du code sur un dépôt ======

===== Récupérer une branche en local =====

  * On peut soit la cloner : <code>git clone branche</code>
  * Soit mettre à jour uniquement les modifications : <code>git pull branche</code>

===== Configurer le repo Git =====

  - Ouvrir Git bash, se placer dans le répertoire du code à pousser, et l'initialiser avec : <code>git init</code> Un nouveau répertoire .git doit apparaître
  - Configurer les identifiants de connexion au repo : <code>git config --global user.email "adresse@mail.fr"
git config --global user.name "username"</code>
  - Indiquer l'URL du repo (GitHub, GitLab ou autre) avec : <code>git remote add origin <URL></code>

===== Pousser des modifications sur une branche =====

Procédure simple pour pousser du code sur un dépôt avec Git :

  - Se placer dans la bonne branche : <code>git branch -M main</code>
  - Ajouter les fichiers à push avec : <code>git add .</code>
  - Faire un commit (push au repo local) en ajoutant un commentaire décrivant la raison du push : <code>git commit -m "description"</code>
  - Pousser le code sur le serveur (ici, on précise la branche source locale et la branche destination, mais ce n'est pas obligatoire) : <code>git push origin main</code>
  - Vérifier l'état de l'opération avec (permet d'afficher aussi les modifications non poussées) : <code>git status</code>

===== Supprimer et renommer des fichiers dans une branche =====

  * Supprimer : <code>git rm fichier</code>
  * Renommer : <code>git mv fichier nouveaunom</code>

===== Ajouter une nouvelle branche =====

  - Créer une nouvelle branche : <code>git branch -c nouvellebranche</code>
  - Pour passer sur la nouvelle branche : <code>git checkout nouvellebranche</code>
  - Pour pousser sur la nouvelle branche (après add et commit) : <code>git push origin nouvellebranche</code>

===== Afficher les modifications sur le repo =====

  * Voir l'historique des modifications __poussées__ sur le repo central : <code>git log</code>
  * Afficher une modification particulière en indiquant son commit ID : <code>git show 674906a6f96c2d3f004525cd80ae1cb29c0c21cc</code>
  * Voir les modifications __non poussées__ sur le repo central : <code>git diff</code>
:!: Ajouter ''--cached'' après un ''git add'' pour afficher les modifications non poussées
  * Afficher la différence entre deux push en utilisant leur commit ID : <code>git diff b721da7..eb01911</code>

===== Rollback de modifications =====

   * Faire un checkout sur le fichier à restaurer en cas de problème : <code>git checkout fichier</code>
   * Annuler l'ajout d'un fichier au stagging effectué avec git add : <code>git restore --staged</code>
   * Restaurer un ancien commit poussé (crée un nouveau commit) : <code>git revert <commit ID></code> 
   * Restaurer un ancien commit et supprimer tous les commits suivants : <code>git reset <commit ID></code>