Git Branch rename : comment changer le nom d’une branche locale

Vous pouvez renommer une branche Git locale ou distante en utilisant la commande –m. Si cela ne pose pas de problème pour les branches locales, vous devez d’abord supprimer l’ancienne version de la branche distante et la remplacer par la nouvelle.

Git est un système de gestion des versions qui est dis­po­nible gra­tui­te­ment et sans licence depuis 2005. La par­ti­cu­la­rité de cet outil est que de nombreux dé­ve­lop­peurs peuvent tra­vail­ler en simultané et en complète autonomie sur un projet. Cela est possible car Git ne fonc­tionne pas avec un dépôt central, mais permet à chaque uti­li­sa­teur de té­lé­char­ger une copie du projet sur son or­di­na­teur local. Celles-ci font également office de back-up. Git se démarque par sa facilité d’uti­li­sa­tion et est rapide à prendre en main. Dans ce Guide Digital, vous trouverez un Tutoriel Git, lequel vous aidera à faire vos premiers pas avec cet outil et vous garantira de pouvoir lancer sans tarder vos propres projets.

Pour com­prendre comment le Git Branch rename fonc­tionne, il peut être judicieux de commencer par jeter un œil à la manière exacte dont Git est structuré et utilisé. Le dépôt Git est crucial à cet égard. Le système de gestion des versions Git utilise ce dernier comme une sorte de bassin col­lec­teur. Tous les fichiers cor­res­pon­dant aux versions pré­cé­dentes et actuelles d’un projet y sont stockés et dis­po­nibles pour tous les dé­ve­lop­peurs. Le moindre chan­ge­ment peut donc être fa­ci­le­ment suivi, tandis que les erreurs peuvent être corrigées plus ra­pi­de­ment. À la dif­fé­rence de systèmes tels que SVN Git ne repose donc pas sur un dépôt central, mais sur de multiples copies locales. Chaque dé­ve­lop­peur peut tra­vail­ler in­dé­pen­dam­ment des autres sur ces dernières.

Si un grand nombre de dé­ve­lop­peurs tra­vail­lent sur un projet en suivant des approches dif­fé­rentes, il est d’autant plus important de séparer les étapes de travail tout en main­te­nant une vision d’ensemble. Dans cette optique, Git a recours à ce qu’on appelle des « branches ». Ainsi, le projet complet se ramifie en plusieurs branches, ou lignes de dé­ve­lop­pe­ment, qui s’écartent du tronc principal et sur les­quelles il est possible de tra­vail­ler en autonomie. On peut ajouter de nouvelles fonc­tion­na­li­tés à l’aide de branches, ou bien corriger des bugs ra­pi­de­ment. Néanmoins, le code d’origine n’est pas modifié.

Il peut arriver que vous deviez renommer une branche Git. Ceci est dû au fait que si son ap­pel­la­tion est in­cor­recte et que d’autres dé­ve­lop­peurs con­ti­nuent à tra­vail­ler avec elle, vous risquez de ren­con­trer des problèmes. Heu­reu­se­ment, malgré l’in­té­gra­tion serrée et les dif­fé­rents forks, effectuer un Git Branch rename n’a rien d’in­sur­mon­table. Pour ce faire, utilisez la commande-m. La syntaxe cor­res­pon­dante suit toujours la même structure :

« git branch -m <old-name> <new-name> ».

Néanmoins, il existe des dif­fé­rences entre les branches que vous pouvez modifier en local et celles qui se trouvent déjà à distance. Ci-dessous, nous vous exposons les étapes à suivre dans chaque cas.

Une branche Git locale n’existe que sur votre or­di­na­teur. Vous l’y soumettez à des mo­di­fi­ca­tions et des tests sans que les autres dé­ve­lop­peurs ne le voient. Renommer une telle branche est donc faisable ra­pi­de­ment.

1. Dans la ligne de commande, sé­lec­tion­nez la Branche Git que vous souhaitez renommer. La commande pour cela est « git checkout alter-name ».
2. Vous recevrez la con­fir­ma­tion suivante du fait que vous avez sé­lec­tionné la bonne branche : « Switched to branch ‘old-name’ »
3. Effectuez à présent le local Git Branch rename. La commande ad hoc est : « git branch -m new-name ».

À titre al­ter­na­tif, vous disposez de l’option de renommer la branche Git via le master. Pour ce faire, suivez les étapes ci-dessous :

1. Rendez-vous dans le master via la commande « git checkout master ».
2. À présent, entrez la commande suivante si vous voulez changer le nom d’une Branche Git : « git branch -m old-name new-name ».
3. Pour vous assurer que le renommage a réussi, récupérez le statut actuel de la branche à l’aide de la commande « git branch –a ».

Dans un dépôt distant, vous ne pouvez pas vous contenter de changer le nom d’une branche Git, car cela en­traî­ne­rait des com­pli­ca­tions. À la place, vous devez supprimer l’ancien nom, puis ajouter la branche avec le nouveau nom. Heu­reu­se­ment, cela reste re­la­ti­ve­ment facile, et c’est faisable en utilisant quelques commandes simples. De même que pour la branche locale, deux options s’offrent à vous :

Pour commencer, assurez-vous que la branche locale dispose du nouveau nom correct. La commande ad hoc est « git branch –a ».

1. À présent, supprimez la branche qui porte l’ancien nom incorrect du dépôt distant. Pour ce faire, utilisez la commande suivante : « git push origin --delete alter-name ».
2. Vérifiez que l’ancienne branche a été cor­rec­te­ment supprimée.
3. Ajoutez à présent la branche avec le bon nom. Pour cela, utilisez la commande « git push origin -u new-name ».
4. Enfin, effectuez une réi­ni­tia­li­sa­tion de la branche en amont pour vous assurer que les chan­ge­ments prennent effet.

Cependant, si vous souhaitez renommer la Branche Git distante à l’aide d’une seule commande, vous disposez également de l’option suivante.

1. Entrez la commande suivante : « git push origin :old-name new-name ».
2. Effectuez ensuite également une réi­ni­tia­li­sa­tion de la branche amont comme décrit ci-dessus.

L’erreur est humaine, et Git a été pensé pour vous permettre de changer le nom des Branches Git en toute sim­pli­cité. Cela peut être fait ra­pi­de­ment et à l’aide de quelques commandes seulement. Si le processus équivaut à un renommage pur et simple pour les branches locales, une sup­pres­sion est né­ces­saire en ce qui concerne les branches distantes. Une fois l’erreur corrigée, cela vaut la peine de re­vé­ri­fier. Par la suite, vous et les autres dé­ve­lop­peurs pouvez continuer à tra­vail­ler sur votre projet sans la moindre res­tric­tion.