Git Pull : té­lé­char­ger et fusionner des contenus

La commande Git Pull té­lé­charge le contenu d’un dépôt distant et effectue ensuite au­to­ma­ti­que­ment une fusion. Une batterie d’arguments permet de ca­rac­té­ri­ser la commande.

Grâce à ses dif­fé­rents dépôts sur lesquels les dé­ve­lop­peurs peuvent tra­vail­ler de manière autonome, Git permet aux uti­li­sa­teurs et à leurs équipes de tra­vail­ler si­mul­ta­né­ment sur un même projet. Les mo­di­fi­ca­tions utiles et im­por­tantes sont ensuite réin­té­grées au projet global. Cependant, pour qu’une telle or­ga­ni­sa­tion fonc­tionne au mieux, il est important que la base soit identique dans chaque dépôt local. C’est à cette condition seulement que les éven­tuelles mo­di­fi­ca­tions ul­té­rieures pourront être intégrées. À ce titre, Git Pull est une commande Git im­por­tante pour le travail avec le logiciel de contrôle de versions.

Git Pull permet de té­lé­char­ger le contenu d’un dépôt distant pour mettre à jour son dépôt local. C’est le meilleur moyen de vous assurer de tra­vail­ler sur la version actuelle. Après avoir effectué les mo­di­fi­ca­tions sur votre dépôt local, té­lé­char­gez les mo­di­fi­ca­tions et les nou­veau­tés dans le dépôt distant à l’aide de la commande Git Push. Tra­vail­ler avec les commandes Git Pull et Push est important, notamment lorsque plusieurs uti­li­sa­teurs tra­vail­lent en même temps sur un projet et que chacun doit avoir la dernière version à chaque instant. On peut con­si­dé­rer la commande Git Pull comme une sorte de mise à jour.

Vous re­trou­ve­rez aussi la syntaxe de Git Pull sur la très utile Git Cheat Sheet avec PDF à té­lé­char­ger. Elle ne contient que la commande pro­pre­ment dite et une in­for­ma­tion sur le dépôt distant. Voici à quoi cela ressemble :

On peut expliquer le fonc­tion­ne­ment de Git Pull au mieux par l’exécution de deux autres commandes Git l’une après l’autre. D’abord, comme avec la commande Git Fetch, l’état actuel d’un dépôt distant est té­lé­chargé avec tous ses contenus. Ensuite, la copie distante et la copie locale sont fu­sion­nées par un Git Merge. Alors que vous devriez nor­ma­le­ment exécuter les deux commandes "git fetch <depot>" et "git merge origin/ <branche-actuelle>" l’une après l’autre, Git Pull les combine et vous épargne une étape de travail.

Outre la syntaxe standard de Git Pull détaillée ci-dessus, quelques variantes ont leur utilité propre. En voici la liste.

Il est possible d’étendre le Git Pull classique pour té­lé­char­ger les contenus du dépôt distant sans créer de nouveau commit de fusion. La commande se présente alors de la façon suivante :

Avec cette variante, Git Pull té­lé­charge là encore tous les contenus d’un dépôt distant, mais au lieu d’une fusion, l’in­té­gra­tion est effectuée avec Git Rebase. Voici sa syntaxe :

Dans cette variante, le Git Pull se fait nor­ma­le­ment mais vous obtenez une liste précise des nouveaux fichiers. Vous savez ainsi avec quels contenus vous pouvez continuer à tra­vail­ler.

Au début, il est possible de confondre les deux commandes Git Pull et Git Fetch. Leur fonc­tion­ne­ment de base est le même : les deux commandes té­lé­char­gent des contenus depuis un ré­fé­ren­tiel distant. Avec Git Fetch cependant, le dépôt local n’est pas modifié. Cette commande met donc à dis­po­si­tion les fichiers né­ces­saires tout en con­ser­vant l’état actuel. Git Pull, en revanche, modifie dans son processus le dépôt local. Si ce mode opé­ra­toire permet de gagner du temps dans certains cas, il peut aussi se trans­for­mer en source de conflit.

Dans l’exemple suivant, voyons comment Git Pull fonc­tionne dans la pratique. Comme la commande exécute deux étapes à la suite, le code est plus court et quelques lignes suffisent. Dans notre exemple, nous utilisons la commande Git Checkout pour passer à notre dépôt local avant d’exécuter Git Pull. Cette commande entraîne le té­lé­char­ge­ment du contenu du dépôt distant avant la fusion directe avec Git Merge. Le dépôt local est ainsi im­mé­dia­te­ment mis à jour. Voici à quoi ressemble le code :

Afin de garder l’his­to­rique aussi linéaire que possible, de nombreux dé­ve­lop­peurs préfèrent utiliser Git Rebase plutôt que Git Merge. Dans ce cas, les propres mo­di­fi­ca­tions sont placées avant les mo­di­fi­ca­tions de l’équipe. Comme Git Pull effectue aussi une fusion, la commande doit être complétée par "--rebase" comme mentionné ci-dessus. Voici le code cor­res­pon­dant :