En travaillant sur un projet en groupe sur git, vous créez une branche. Sauf que vous vous rendez compte qu’elle ne respecte pas la convention déterminée par l’équipe ou tout simplement que le nom est incorrect. Git nous permet de renommer notre branche très facilement et nous allons voir ensemble comment procéder.

Nous allons prendre pour exemple la branche feature/hello comme étant celle à renommer et qui deviendra feature/hello-there

live server vscode install extension

Renommer la branche en local

git branch -m feature/hello feature/hello-there  

live server vscode install extension

Supprimer l’ancienne branche

git push origin :feature/hello  

live server vscode install extension

Pousser vers la nouvelle branche

On pousse sur la nouvelle branche tout en définissant que la branche locale suivra la nouvelle branche distante

git push --set-upstream origin feature/hello-there  

live server vscode install extension

live server vscode install extension

Conclusion

git branch -m old new  
git push origin :old
git push --set-upstream origin new  

🤔 Pourquoi ne pas en faire un alias ?

On a plusieurs choix, on peut soit créer un alias git ou un alias bash. Dans cet exemple, je vous mets à disposition un alias bash. J’ai mis aussi un lien pour les alias git 😉

alias gmv='mv() { git branch -m $1 $2; git push origin :$1; git push --set-upstream origin $2; }; mv'

# exemple d'utilisation
gmv feature/hello-there feature/hello-there-another-time

Liens utiles

Pour les conventions git sur mes projets je me base sur les conventions de Angular.

https://github.com/angular/angular/blob/master/CONTRIBUTING.md

Avant de partir…
Merci pour votre lecture ! 😊