Comment renommer une branche dans Git

By Corentin BURTIN

La création de branches est un exercice trivial dans Git. Malheureusement, les tâches triviales reçoivent rarement l’attention qu’elles méritent, et des erreurs se produisent. Si vous avez mal nommé une branche, il faudra la renommer. Voici comment faire.

Pourquoi les noms de branches sont importants dans Git

Dans les systèmes de contrôle de version (VCS) classiques, tout ce qui concernait les branches était un gros problème. Il fallait une compréhension coordonnée du fait qu’une branche était ajoutée ou fusionnée, et toutes les personnes utilisant ce dépôt devaient s’assurer qu’elles ne faisaient rien – ou oubliaient de faire quelque chose – pour que l’opération se déroule et réussisse.

Les opérations impliquant des branches étaient souvent très lentes, aussi. Il y avait une pénalité de temps pour l’utilisation des branches. Git a été conçu dès le départ pour être différent. Parce que c’est un système de contrôle de version distribué, chaque utilisateur dispose d’une copie du dépôt complet sur sa machine locale.

Créer une branche sur votre machine locale n’affecte personne d’autre à moins que vous ne poussiez la branche vers un dépôt distant. Et dans Git, les opérations de branchement sont conçues pour être aussi faciles à utiliser que rapides à réaliser. Le branchement dans Git est très peu coûteux en termes de calcul. Il s’agit d’une action triviale à l’intérieur du dépôt local.

En fait, les développeurs sont encouragés à se brancher, et à se brancher souvent. Les branches ne sont qu’un outil de plus dans votre VCS dont vous bénéficiez. Les branches ne sont pas de grandes choses effrayantes dans Git, elles sont l’une de ses fonctionnalités les plus utilisées.

Mais la familiarité peut conduire au mépris. Ou, du moins, à un regard désinvolte sur les branches. La création de branches peut être rapide et simple dans Git, mais vous devez quand même être concentré lorsque vous créez une branche. Il est facile de se tromper de nom de branche, ou de taper le mauvais nom, ce qui donne une branche mal nommée.

A lire également :   Pour les joueurs : tout ce que vous devez savoir sur les RPGs gratuits sur PlayStation

Si la branche doit être poussée vers le dépôt distant à un moment donné, elle doit être correctement orthographiée. Si ce n’est pas le cas, il y aura confusion lorsque d’autres personnes essaieront de l’utiliser.

Git rebase : Tout ce que vous devez savoir

Lister les branches dans Git avant de les renommer

Vérifier quels sont les noms des branches actuelles est une bonne première étape. La commande git branch liste les branches pour nous. Vous pouvez voir les branches dans le dépôt local avec cette commande :

git branch

Lister les branches locales à l’aide de la commande git branch

Les branches sont listées pour nous. La branche courante est surlignée en vert, et avec un astérisque.

Pour voir les branches et leurs commits, vous pouvez utiliser la commande show-branch.

git show-branch

Lister les branches et leurs commits avec la commande git show-branch

Vous pouvez voir les branches sur le dépôt distant en incluant l’option -r (remote).

git branch -r

Liste des branches distantes avec la commande git branch -r

Pour voir les branches locales et distantes avec une seule commande, utilisez l’option -a (all).

git branch -a

Lister les branches locales et distantes avec la commande git branch -a

Nous avons plus de branches locales que de branches distantes. La branche « feature16 » n’a pas encore été poussée vers le dépôt distant. C’est juste un aspect du fonctionnement normal, pas un problème.

Notre problème est que la branche « feature19 » aurait dû être nommée « feature18 ». C’est donc cette erreur que nous allons corriger.

Comment renommer une branche locale dans Git ?

Il y a deux façons de renommer une branche localement. Vous pouvez extraire la branche et la renommer, ou vous pouvez renommer la branche pendant que vous travaillez sur une autre branche.

A lire également :   Comment monter une image ISO dans Windows 7, 8, et 10

Pour renommer la branche courante, assurez-vous que vous avez extrait et que vous utilisez la branche que vous voulez renommer. Utilisez ensuite la commande git branch avec l’option -m (move).

git checkout feature19

git branch -m feature18

Extraction de la branche « feature19 » et renommage de celle-ci

Nous avons extrait la branche « feature19 » et l’avons renommée en « feature18 ». Voyons à quoi ressemblent nos branches maintenant.

git branch

Liste des branches pour vérifier que la branche « feature19 » a été renommée en « feature18 ».

Notre branche a maintenant le nom correct dans le dépôt local.

Si vous le souhaitez, vous pouvez renommer une branche lorsque vous travaillez dans une autre branche. Voici un exemple où nous travaillons dans la branche « master ».

git branch

Liste des branches pour vérifier que nous sommes sur la branche master

La commande que nous utilisons est la même que précédemment, mais nous devons fournir le nom actuel de la branche que nous renommons, ainsi que le nouveau nom que nous voulons lui donner.

git branch -m feature19 feature18

git branch

Renommer une branche à partir d’une autre branche

Encore une fois, la branche dans notre dépôt local a été renommée avec le nom correct.

Comment renommer une branche distante dans Git ?

Le dépôt distant contient toujours la branche avec l’ancien nom. Pour renommer une branche distante, il faut supprimer l’ancienne branche et pousser la nouvelle branche.

Si d’autres utilisateurs utilisent cette branche et y poussent des commits, vous devriez faire un pull avant de la renommer localement. Cela garantit que votre dépôt local est à jour et que les modifications apportées par les autres utilisateurs ne seront pas perdues. En retirant leurs changements de votre dépôt avant de renommer la branche localement, ces changements seront dans la nouvelle branche lorsque vous la repousserez vers le dépôt distant.

A lire également :   Meilleures applications gratuites de télévision en direct pour Android - Regardez des sports, des films et bien plus encore.

Jetons un coup d’oeil à l’état de nos branches. Nous allons utiliser l’option -a (all) pour voir à la fois les branches locales et distantes.

git branch -a

Liste des branches locales et distantes avec la commande git branch -a

Nous devons supprimer « feature19 » du dépôt distant, et pousser « feature18 » vers le dépôt distant.

git push origin –delete feature19

Suppression d’une branche distante avec l’option git –delete

Le mot de passe du dépôt distant vous sera demandé. Une fois que la suppression a eu lieu, vous verrez un message de confirmation.

Maintenant nous allons pousser notre nouvelle branche vers le dépôt distant, et utiliser l’option -u (set upstream)

git push origin -u feature18

Pousser une branche vers le dépôt distant

Encore une fois, le mot de passe pour le dépôt distant vous sera demandé. La nouvelle branche est poussée vers le dépôt distant, et on nous dit que la branche « feature18 » est configurée pour suivre les changements dans notre copie locale de la branche.

Vérifions une fois de plus dans quel état se trouvent nos branches locales et distantes.

git branch -a

Liste des branches locales et distantes avec la commande git branch -a

Notre branche a été renommée avec succès à la fois localement et à distance, et la branche distante suit les changements de notre branche locale.

Renommer les branches est simple

Avec Git, renommer des branches est simple. Si vous êtes la seule personne qui utilise un dépôt ou une branche à renommer, c’est très simple.

Si d’autres personnes partagent la branche, assurez-vous de leur communiquer que vous allez renommer la branche, et qu’ils doivent pousser tout travail non engagé. Une fois qu’ils ont poussé, vous pouvez retirer la branche, puis renommer votre branche localement et à distance.

Laisser un commentaire