Récupérer, tirer et pousser

Pull

Trois modes, choisis dans la liste déroulante : par défaut, avance rapide uniquement, ou rebase. Les changements locaux sont remisés puis restaurés automatiquement autour du pull : une copie de travail sale ne vous bloque donc pas.

Une branche qui ne suit rien

git pull, c'est une récupération suivie d'une fusion, et la fusion doit savoir dans quoi fusionner — la branche amont. Une branche créée en local, ou sortie sans suivi, n'en a pas. La récupération réussit quand même, une longue liste de refs origin/* mises à jour défile, puis git s'arrête sur "There is no tracking information for the current branch". Rien n'a été tiré et rien n'est cassé : la seconde moitié n'avait tout simplement pas de cible.

Gitcito lit cette erreur et propose la réparation sous forme de bouton, en choisissant laquelle selon que le distant porte déjà la branche :

Le distant proposé est origin s'il existe, sinon le premier de la liste. Le cas dans lequel vous êtes se lit dans les refs de suivi, pas sur le réseau : la réponse reflète donc la récupération qui vient d'avoir lieu.

Push

Les push forcés utilisent toujours --force-with-lease — la variante sûre, qui refuse si le distant a bougé depuis votre dernier regard. Pousser en force une branche protégée demande confirmation (la liste se trouve dans la roue dentée des réglages du dépôt).

Aucun distant

Push, pull et fetch ont besoin d'une destination. Un dépôt sans aucun — un git init tout frais, un clone dont l'origin a été retiré — faisait que ces boutons ne faisaient rien, ou qu'un fetch vide comptait pour un succès. Ils ouvrent maintenant Ajouter un distant, avec un avertissement, pour coller une URL ou créer le dépôt sur l'hôte. L'ajouter termine l'action commencée : un push publie la branche courante, un pull récupère puis tire, un fetch ne fait que récupérer.

Le fetch automatique en arrière-plan reste silencieux s'il n'y a rien à récupérer. Il n'ouvre pas de dialogue à l'horloge.

Plus d'un distant

Le bouton Pousser vise l'amont de la branche. La flèche à côté propose en plus, dès qu'un dépôt a plus d'un distant :

Les deux mêmes actions se trouvent sur la ligne propre à chaque distant dans la barre latérale, qui est généralement là où vous êtes quand la question se pose.

Un refus n'annule pas le reste. Pousser un fork et son amont est exactement le cas où un côté refuse et où l'autre devrait quand même passer : chaque distant rapporte donc séparément — les succès sont nommés dans une seule notification, et chaque échec obtient la sienne avec la raison donnée par git.

Seul le premier distant de la liste définit l'amont de la branche. Une branche a un seul amont, et le dernier distant poussé n'est pas automatiquement celui que vous voulez qu'elle suive.

Les deux chemins exécutent les mêmes vérifications qu'un push ordinaire — la confirmation de branche protégée et le garde-fou des secrets. Publier vers deux distants, c'est deux fois l'exposition, pas la moitié de la prudence.

Les branches sur lesquelles vous n'êtes pas

git pull ne déplace jamais que HEAD : c'est pourquoi la plupart des clients exigent d'extraire une branche avant de pouvoir la mettre à jour. Pas Gitcito : clic droit sur n'importe quelle branche locale — dans la barre latérale ou sur son badge dans le graphe — et vous obtenez Tirer <branche> et Pousser <branche>, qui agissent sur cette branche.

Tirer est grisé pour une branche qui ne suit rien — il n'y a rien à tirer. Sur la branche où vous êtes, les deux retombent sur le pull normal, qui met aussi la copie de travail à jour.

La limite à connaître : une branche qui a divergé de son amont est refusée, avec un message qui le dit. Réconcilier une divergence, c'est une fusion ou un rebase, et les deux exigent une copie de travail — ce cas-là coûte donc encore une extraction. La poussée forcée d'une branche où vous n'êtes pas est proposée quand le distant refuse ; le chemin « tirer puis réessayer », non, pour la même raison.

Fetch

Récupérer a son propre bouton dans la barre d'outils, à côté de Tirer. Il récupère depuis tous les distants et élague, de sorte que vos refs origin/* et tous les compteurs d'avance/retard sont à jour — et il ne touche ni votre branche ni votre copie de travail. C'est le bouton à utiliser quand vous voulez voir ce que les autres ont fait sans déplacer votre propre travail.

Il y a aussi une récupération automatique en arrière-plan à l'intervalle que vous fixez (Réglages → Général). Survolez le bouton Récupérer et l'ancienneté apparaît en dessous — il y a 4 min — en ambre dès qu'une récupération dépasse quinze minutes. Elle ne prend jamais de place dans la barre d'outils, car elle répond à une question qu'on ne se pose qu'en tendant la main vers le bouton. Elle est lue dans FETCH_HEAD : un git fetch lancé dans un terminal compte donc autant qu'un lancé ici.

Un fetch qui découvre de l'histoire réécrite le dit : une notification nomme la branche, et sa ligne gagne un marqueur qui ouvre ce qui a changé depuis exactement au commit qu'elle désignait auparavant.

Beaucoup de dépôts à la fois

• Un onglet de groupe peut faire Tout récupérer / Tout tirer sur son sous-arbre entier.
• Le centre de contrôle le fait à l'échelle de l'espace de travail, et peut tirer uniquement les dépôts réellement en retard.

Distants

Ajoutez, modifiez, supprimez et récupérez des distants individuels depuis la barre latérale. Les lignes de branche portent des badges de présence par distant : vous voyez donc d'un coup d'œil quels distants ont une copie d'une branche.

Fetch, pull ou push sans distants ouvre ce même dialogue Ajouter un distant, au lieu de réussir dans le vide. Voir récupérer, tirer et pousser.

Voir aussi : Centre de contrôle · Hébergement et pull requests