Comment renommer une branche Git

Savoir comment renommer une branche dans Git est une compétence pratique. Vous êtes peut-être l’une des rares personnes à avoir dès le départ un plan inébranlable sur ce que devraient être les noms de vos branches, mais pour la plupart des développeurs, renommer est une tâche fréquente.

Mais comment renommer exactement une branche sur Git ? Cet article vous expliquera tout ce que vous devez savoir.

Instructions pas à pas pour renommer une branche Git locale

La façon dont vous renommez votre branche dépend de ce que vous faites actuellement. Si vous vous trouvez sur la branche que vous souhaitez renommer, procédez comme suit :

1. Ouvrez le Terminal.
2. Taper git branch -m nouveau-nomen remplaçant « nouveau-nom » par le nom que vous souhaitez donner à la branche.
   

Si vous n’êtes pas sur la branche que vous souhaitez renommer, il y a une ligne supplémentaire à ajouter :

1. Ouvrez le Terminal.
2. Taper git branch -m ancien-nom nouveau-nomen remplaçant « ancien-nom » par le nom actuel et « nouveau-nom » par le nouveau nom.
   

Gestion des succursales distantes

Après avoir renommé votre branche localement, si vous l’avez transférée vers un référentiel distant, vous devrez également y mettre à jour les éléments.

1. Supprimez l’ancienne branche de la télécommande. Taper git push origin – supprimer l’ancien nom dans votre Terminal.
   
2. Ensuite, poussez le nouveau nom de branche avec git push origin -u nouveau nom.
   

Méthodes alternatives de renommage

La méthode de renommage ci-dessus est la manière la plus populaire de renommer une branche. Mais il existe des alternatives.

Utiliser les outils de l’interface graphique Git

Utiliser le terminal n’est pas un défi majeur, mais si vous n’êtes pas fan de la ligne de commande, de nombreux outils d’interface utilisateur graphique (GUI) pour Git vous permettent de renommer des branches en quelques clics. Des outils comme GitKraken, Arbre Sourceou la Bureau GitHub L’application dispose d’interfaces intuitives pour gérer les branches, notamment pour les renommer.

Renommer des branches dans les référentiels en ligne

Pour les branches déjà transférées vers des référentiels en ligne, des plateformes comme GitHub, GitLabet Bitbucket vous permet également de renommer les branches au sein d’une interface graphique directement via leurs interfaces Web. Si vous êtes loin de votre environnement de développement local mais que vous souhaitez quand même renommer une branche rapidement ou préférez simplement la voie visuelle, c’est sans aucun doute la voie à suivre.

Scripts et automatisation

Pour ceux qui aiment les scripts, non seulement pour leurs projets mais pour Git lui-même, vous pouvez écrire des scripts shell simples pour automatiser le changement de nom. C’est particulièrement utile si vous gérez plusieurs branches ou référentiels à la fois. Cependant, notez qu’il s’agit d’un moyen plus avancé de renommer des branches et que vous devez avoir une bonne compréhension des scripts shell et des commandes Git.

Si vous êtes à l’aise avec les scripts et maîtrisez bien les commandes Git, l’automatisation du renommage des branches vous fera gagner énormément de temps, en particulier lorsque vous jonglez avec plusieurs branches ou référentiels.

Voici un exemple :

1. Ouvrez un éditeur de texte. Vous pouvez utiliser n’importe quel éditeur de texte de votre choix – Visual Studio Code, Atom ou même le bon vieux Bloc-notes.
   
2. En haut de votre fichier de script, écrivez #!/bin/bash. Cette ligne indique à votre système que le script doit être exécuté dans le shell Bash.
   
3. Démarrez votre script en définissant des variables pour les anciens et les nouveaux noms de branche. Par exemple:
   old_branch=”ancien-nom-de-branche” new_branch=”nouveau-nom-de-branche”
   
4. Utilisez les commandes Git pour renommer une branche en utilisant les variables que vous venez de définir. Comme:
   git branch -m $old_branch $new_branch git push origin :$old_branch git push –set-upstream origin $new_branch
   
5. Enregistrez votre script avec une extension .sh, comme rename-branch.sh.
   
6. Pour le rendre exécutable, ouvrez votre Terminal et courir chmod +x renommer-branche.sh.
   
7. Exécutez votre script en tapant ./renommer-branche.sh dans le Terminal.
   

Une fois que vous utilisez ces commandes, elles renomment la branche localement, suppriment l’ancienne branche et poussent la nouvelle branche vers la télécommande.

Utiliser les alias Git

Si vous devez souvent renommer des branches, vous pourriez obtenir un gain considérable en créant un alias Git – votre propre raccourci pour étendre ou simplifier les commandes Git. Par exemple, vous pouvez créer un alias comme « git ren » qui exécute la commande « git branch -m ». C’est beaucoup plus rapide et plus facile à retenir, ce qui vous évite de devoir taper beaucoup de texte. Créons un alias qui vous permet d’utiliser « git ren » au lieu de la commande complète « git branch -m ».

Exécutez cette commande :

Configuration Git –alias global.ren ‘branche -m’

Au lieu de taper « git branch -m old-branch new-branch », vous pouvez simplement taper git ren ancienne branche nouvelle branche.

Cette commande indique à Git de créer un alias global nommé « ren » qui exécutera « branch -m ». C’est un petit changement, mais cela rend la commande plus facile à retenir et plus rapide à saisir.

La beauté des alias Git est que vous pouvez les ajuster comme bon vous semble. Si vous utilisez souvent une commande Git particulière, vous pouvez créer un alias pour la rendre plus accessible. Suivez simplement le modèle ci-dessus, mais au lieu de « ren » et « branch -m », insérez l’autre alias et la commande de votre choix.

Renommer des branches dans les environnements de développement intégrés (IDE)

Comme vous le savez peut-être, de nombreux environnements de développement intégrés (IDE) comme Visual Studio Code, IntelliJ IDEA ou Eclipse intègrent la prise en charge de Git. Cette prise en charge s’étend à la gestion et au changement de nom des succursales. Ces IDE disposent souvent d’un moyen plus convivial de renommer les branches dans l’interface graphique (similaire à certains des outils mentionnés précédemment) sans la ligne de commande.

Pourquoi même renommer une succursale ?

Renommer une branche peut sembler une petite chose, mais cela peut faire une grande différence. À la base se trouvent la clarté et l’interprétation.

Par exemple, vous avez peut-être commencé avec une branche pour laquelle vous avez donné un nom d’espace réservé, « nouvelle fonctionnalité ». À l’époque, cela semblait peut-être suffisant, car vous ne saviez pas exactement comment la fonctionnalité allait se développer. Mais au fur et à mesure que le projet évoluait, il s’est transformé en quelque chose de plus spécifique, comme l’ajout d’une nouvelle passerelle de paiement. Le renommer « add-stripe-integration » indique instantanément à tout le monde ce qui se passe dans cette branche.

Il s’agit d’un mini-babillard qui diffuse l’objectif de la branche. Cela pourrait également aider à suivre les progrès et à organiser le travail, en particulier lorsque vous gérez plusieurs succursales.

Meilleures pratiques pour la dénomination des succursales

Pendant que vous y êtes, parlons de la dénomination des branches en général. Vous voulez quelque chose de descriptif mais pas un roman, un nom qui se situe à mi-chemin entre informatif et concis. Si vous créez une étiquette pour un dossier de fichiers, vous voulez que quiconque le récupère sache ce qu’il contient sans lire une phrase entière. Des noms comme « fix-login-issue » ou « Enhance-image-upload » fonctionnent très bien. Pendant ce temps, « connexion » ou « problème de connexion résolu avec-2fa-no-password-credentials » peut être trop peu ou trop. Un bon nom vous indique exactement ce qu’il y a dans la boîte sans l’ouvrir. Restez simple et descriptif pour faciliter la vie de tous les membres de l’équipe.

Un mot d’avertissement

Un petit avertissement sur le renommage des branches sur le serveur distant. Puisque vous partagez votre travail avec une équipe, cela peut revenir à réorganiser le mobilier d’un bureau partagé. Si vous le faites sans le dire à personne, vous allez avoir des coéquipiers confus (et peut-être ennuyés). Renommer des branches que d’autres utilisent activement peut perturber leur flux de travail. Communiquez toujours avec votre équipe avant de procéder au changement. Cela peut éviter bien des maux de tête et maintenir l’harmonie du codage.

Se persifier avec des noms intelligents

Renommer une branche dans Git est facile une fois que vous savez comment procéder. Il s’agit d’un petit outil dans votre arsenal Git, mais puissant pour garder vos projets ordonnés et compréhensibles. Faites simplement preuve de bon sens et rendez vos noms descriptifs mais suffisamment simples pour être compris d’un simple coup d’œil.