Git

2.1.1. Configuration basique

2.1.2. Configuration avancé

1. Les alias
   

   git config alias.commande 'commande'
   # exemple
   git config alias.last 'log -1 HEAD'
   git last # exécute l’alias
   

   Il est possible de rajouter des options lors de l’appel à l’alias, ils vont se rajouter après la commande de l’alias.

2.3.1. Enlever des fichiers ou des dossiers

doc/*
*.class

2.3.2. Ajouter une origine au dépôt

2.4.1. Usage classique

1. MAJ du dépôt local
   
   • git fetch remote : va mettre à jour le dépôt local avec les informations du dépôt distant (le nom du remote est obligatoire pour le premier fetch). Il faut cependant se déplacer ensuite manuellement pour aller sur le dernier commit.
   • git pull : met à jour et se déplace sur le dernier commit.
2. Commits
   
   • `git revert sha1` : fait un commit contenant l’inverse du sha1
   • `git add file && git commit –amend` : ajoute un fichier au dernier commit
   • `git commit –amend` : modifie le message du commit précédent
3. Voir les modifications
   

   git log

   affiche l’historique du dépôt

   --graph

   affiche sous forme de graphe

   -p N

   affiche les N derniers commits

   git show sha1

   affiche les informations du commit et ses modifications

4. Informations sur les fichiers
   

   Pour pouvoir voir plus en détail un fichier et ses modifications, il est possible de faire un git blame fichier. La première colonne indique le commit modifiant le fichier (^ = commit ayant créer le fichier), la deuxième l’autheur, puis la date de création et pour finir la ligne du fichier. Avec -L on peut préciser les lignes à montrer :

   -L 10,20

   les lignes 10 et 20

   -L 10,+

   tout à partir de la ligne 10

   -L 10,+4

   4 lignes après la ligne 10

5. Mettre de côté les modifications
   

   Pour mettre de côté des modifications, il est possible d’utiliser la commande git stash save "message" afin de les sauvegarder pour plus tard. Pas besoin de faire des commits pour mettre les fichiers de côtés. Ces modifications seront sauvegardés avec un index. Pour les restaurer dans l’espace de travail, il faut faire git stash pop index. Pour récupérer la liste des index, il faut faire git stash list. Pour voir les informations du stash : git stash show index.

   git stash save = git stash. git stash pop = pop le dernier stash.

   Exemple d’utilisation en cas de conflit:

   git pull
   # erreur !
   git stash
   git pull
   git stash pop
   # régler les derniers conflits
   

6. Rebase
   

   Change le parent d’un commit.

   Se fait automatiquement avec git pull --rebase.

   1. L’utiliser de manière interactive
      

      git rebase -i sha1
      # modifier le fichier selon ses gouts
      # le fichier est trié par ordre chronologique (+ancient au +récent)
      # ce fichier est un script qui sera exécuté. Pour modifier un commit, 
      # il faut remplacer le pick par r par ex (+d’infos dans le fichier).
      

      Option	Description
      p	Ne rien faire
      r	Réécrire le commit
      drop	Supprime le commit, possible de supprimer la ligne au lieu de mettre d. Possibilité de conflit à gérer
      squash	Fusionne le commit avec son commit parent
      edit	Laisse la main pour faire ce qu’on souhaite (ajout de fichiers…)

      Pour découper un commit, on utilise edit sur le commit et il suffit de rajouter les fichiers avec add et les commit avant de continuer le rebase.

      Pour changer l’ordre des commits, il faut changer la ligne où ils se trouvent.

      pick commitA -> pick commitA
      pick commitB -> pick commitC
      pick commitC -> pick commitB
      pick commitD -> pick commitD
      

7. Se déplacer de commit en commit
   
   • git checkout sha1 : déplace HEAD sur le sha1
   • git checkout HEAD~2 : déplace HEAD 2 commit en arrière.

   HEAD^ = parent du commit actuel

8. Déplacer la tête de la branche
   

   git reset sha1 : déplace la branche sur le commit (marche aussi avec HEAD~X)

   On peut annuler un reset avec ORIG-HEAD comme commit.

   1. Arguments
      
      • --hard : supprime toutes les modifications qu’il y ai pu avoir (= git checkout sur tous les fichiers)
      • --mixed (option par défaut) : les modifications faites sont sauvegardées mais les fichiers indexés ne le sont plus
      • --soft : idem que --mixed mais les fichiers indexés le restent
9. Historique position
   

   git reflog : affiche l’historique des différentes positions de HEAD. Il est possible de rajouter -N qui affichera les N dernières positions (git reflog -4 par ex).

   Il est aussi possible de rajouter --reflog à la commande git log.

2.4.2. Commandes pour les branches

1. Copier un commit dans une branche
   

   git cherry-pick sha1 : duplique le commit passé en pramètre

2. Rebase d’une branche
   

   Aligne tous les commits de la branche dans l’autre branche (master ici).

   # depuis la branche à rebase
   git rebase master
   # régler les conflits et si conflits:
   # git add files
   # git rebase --continue
   git checkout master
   git merge branche
   

3. Suppression
   

   En local: git branch -d nom. Il faut ensuite pousser cette suppression avec git push origin --delete nom.

2.5.1. Commandes

2.6.1. Hooks

1. Local
   

   Si la valeur de retour n’est pas 0, on arrête tout.

   Liste non exhaustive des hooks existant pour un dépôt local:

   • pre-commit : juste après git commit. Pas d’arguments
   • prepare-commit-msg : juste après pre-commit, 3 arguments : nom fichier tmp contenant le message, type de commit (-m, -t, merge ou squash), sha1 (pour -c -C ou –amend)
   • commit-msg : juste après l’entré du message du commit, 1 argument : nom fichier tmp contenant le message
   • post-commit : juste après la création du commit (aucune anulation possible si retourne !0). Pas d’arguments
   • post-checkout : juste après commande checkout. 3 arguments : ref HEAD pred, ref nouv HEAD, checkout de branche (1) ou fichier (0). Aucun changement si ret !0
   • pre-rebase : juste après commande rebase mais avant la rebase. 2 arguments: branch upstream, branche rebasée (vide si la branche est la même)

   On peut les ignorer en ajoutant -n à la commande commit.

2. Serveur
   

   Les scripts ont la même règle que les hooks locaux.

   Liste non exhaustive des hooks existant pour un dépôt distant:

   • pre-receive : en recevant un push et avant d’intégrer le code reçu. Pas d’argument
   • update : après le pre-receive. 3 arguments : nom branche maj, sha1 du commit actuel de la branche, sha1 du nouveau commit de la branche
   • post-receive : après push réussi. Pas d’arguments et n’arrête rien. Permet de faire des notifications pour le CI/CD par ex.

2.6.2. Voir les références

2.6.3. Faire une recherche dichotomique pour trouver un bug

git bisect start
git bisect good sha1 # le commit sans le bug
git bisect bad sha1 # le commit avec le bug

# good et bad sans sha1 = HEAD.
# un git checkout est fait automatiquement en se mettant au milieu
# si le bug est toujours présent, on refait git bisect bad 
# ou git bisect good s’il n’y est plus
# lorsque le bug est trouvé de manière sur, il affiche des infos sur le commit

git bisect reset # sort du mode bisect et retourne sur le commit précédent cette commande

git bisect start
git bisect good sha1 # le commit sans le bug
git bisect bad sha1 # le commit avec le bug
git bisect run script # le script retourne 0 = good, autre = bad
# attendre
git bisect reset

2.6.4. Autres