Add: changer auteurs commits

content/posts/changer-auteurs-commit.fr.md

@@ -0,0 +1,148 @@
++++
+date = '2025-10-20T00:01:00+02:00'
+draft = true
+title = "Réécrire l'historique Git : Changer les auteurs des commits"
++++
+
+Depuis peu j'ai effectué un changement de cap, de vision, de volonté. J'ai viré certains services, certaines habitudes. J'en ai ancré d'autres. Ça m'est déjà arrivé - et ça m'arrivera surement encore - et à chaque fois, la même chose, un changement de pseudo, voire une nouvelle url, et hop !
+
+Pour cette fois ci, je voulais changer les auteurs de commits des dépots git, pour ne pas avoir plusieurs identité sur le même dépôt, ayant peur que certaines personne s'inquiète d'une éventuelle schizophrénie.
+
+## Cas 1 : Remplacer tous les auteurs
+
+Si vous souhaitez remplacer **tous** les auteurs par une seule identité :
+
+```bash
+git filter-repo --commit-callback '
+commit.author_name = b"Votre Nom"
+commit.author_email = b"email@exemple.com"
+commit.committer_name = b"Votre Nom"
+commit.committer_email = b"email@exemple.com"
+' --force
+```
+
+Cette commande parcourt tous les commits et remplace systématiquement l'auteur et le committer.
+
+**Points importants :**
+- Les valeurs doivent être en bytes Python (`b"..."`)
+- Le flag `--force` est nécessaire pour les remplacements (sans confirmation)
+- Cette opération recrée les commits, ce qui change leurs SHA
+
+## Cas 2 : Remplacer un auteur spécifique
+
+Si vous aviez plusieurs auteurs mais voulez corriger un seul d'entre eux, utilisez une condition :
+
+```bash
+git filter-repo --commit-callback '
+if commit.author_name == b"Ancien Nom":
+    commit.author_name = b"Nouveau Nom"
+    commit.author_email = b"nouvel@email.com"
+    commit.committer_name = b"Nouveau Nom"
+    commit.committer_email = b"nouvel@email.com"
+' --force
+```
+
+## Cas 3 : Remplacer uniquement le nom ou uniquement l'email
+
+Vous pouvez aussi appliquer des transformations plus granulaires. Par exemple, remplacer uniquement les noms :
+
+```bash
+git filter-repo --name-callback 'return b"Nouveau Nom"' --force
+```
+
+Ou uniquement les emails :
+
+```bash
+git filter-repo --email-callback 'return b"nouvel@email.com"' --force
+```
+
+## Workflow complet : exemple pratique
+
+Imaginons que vous avez des commits avec le nom "Tartanpion" et l'email "ancien@email.com", et vous souhaitez les corriger :
+
+### 1. Vérifiez les auteurs actuels
+
+Avant de commencer, voyez qui a contribué :
+
+```bash
+git log --format='%an <%ae>' | sort | uniq
+```
+
+Cela affiche une liste unique de tous les auteurs.
+
+### 2. Lancez le filtre
+
+```bash
+git filter-repo --commit-callback '
+if commit.author_name == b"Tartanpion":
+    commit.author_name = b"DuN0Z"
+    commit.author_email = b"dunoz@porzh.me"
+    commit.committer_name = b"DuN0Z"
+    commit.committer_email = b"dunoz@porzh.me"
+' --force
+```
+
+### 3. Vérifiez le résultat
+
+```bash
+git log --format='%an <%ae>' | sort | uniq
+```
+
+Les auteurs devraient maintenant être corrects.
+
+### 4. Vérifiez l'intégrité
+
+```bash
+git fsck
+```
+
+Cette commande vérifie que le référentiel Git est cohérent.
+
+### 5. Forcez le push
+
+Puisque vous avez modifié l'historique, vous devez forcer le push sur le serveur distant :
+
+```bash
+git push origin master --force
+```
+
+**Attention :** Le `--force` réécrit l'historique sur le serveur. Assurez-vous que c'est acceptable dans votre équipe ou repo personnel.
+
+## Pièges courants
+
+**Refus de git filter-repo sans --force :** Par défaut, Git refuse de réécrire l'historique. Le flag `--force` l'autorise. Utilisez-le consciemment.
+
+**Les anciennes références restent locales :** Après le filtrage, Git conserve les anciennes références dans `.git/refs/original/`. Vous pouvez les supprimer :
+
+```bash
+rm -rf .git/refs/original/
+git reflog expire --expire=now --all
+git gc --prune=now
+```
+
+**Collaborateurs affectés :** Si d'autres personnes utilisent ce dépôt, elles devront re-cloner ou rebaser leurs branches locales. Coordonnez-vous ! Moi je m'en fou, ce sont des dépots perso, sur mon instance perso que personne connait. Comme ce blog d'ailleurs, j'adore jeter des bouteilles à la mer ! :-)
+
+## Après le push forcé
+
+Une fois le push forcé effectué, le serveur distant reflète les nouveaux commits. Les anciens commits restent temporairement accessibles (garbage collection), mais ils sont progressivement nettoyés.
+
+Pour les collaborateurs qui auraient cloner l'ancien historique :
+
+```bash
+git fetch origin
+git reset --hard origin/master
+```
+
+## Conclusion
+
+Réécrire l'historique Git avec `git filter-repo` est une opération puissante mais à manier avec prudence. Elle est particulièrement utile pour corriger des erreurs de configuration ou pour nettoyer des commits avant de les partager largement. Toujours double-vérifier, et n'hésitez pas à tester sur une copie avant d'affecter votre vrai dépôt.
+
+Si vous cherchez à éviter ce problème à l'avenir, configurez correctement votre identité Git :
+
+```bash
+git config --global user.name "Votre Nom"
+git config --global user.email "email@exemple.com"
+```
+
+Surtout valable si vous avez plusieurs machines, ça peut vite devenir le bordel. Ou alors, vous les mettez toutes sous NixOs, et en faisant votre configuration, vous importez le meme fichier `git.nix` partout. Vous savez quoi ? une machine n'avais pas la même identité, le Mac .... un bon retour de baton dans la gueule ça !
+Et vérifiez occasionnellement avec `git log` que vos commits sont signés correctement.