Le cockpit Git

Dans le Navigateur, dépliez un projet puis utilisez son bouton Git. Vous pouvez aussi faire un clic droit sur le projet et choisir Ouvrir Git, ou ouvrir Aperture avec ⌘K / Ctrl K et rechercher le projet ou la commande Git.

Singularity ouvre un onglet de cockpit lié à ce projet. Ouvrir Git depuis un autre projet crée ou active son propre onglet : les dépôts ne sont pas mélangés.

L’en-tête affiche la branche courante. Les indicateurs en avance et en retard comparent cette branche à sa branche amont : en avance correspond aux commits locaux restant à publier ; en retard, aux commits distants restant à intégrer.

Les changements sont séparés en Fichiers indexés (contenu du prochain commit) et Fichiers non indexés. Les nouveaux fichiers apparaissent comme non suivis. Les totaux d’ajouts et de suppressions donnent l’ampleur du diff ; sélectionnez un fichier pour le lire.

Utilisez le bouton d’un fichier pour l’indexer, ou l’action du groupe pour indexer tous les fichiers concernés. Dans le diff, les contrôles d’un bloc permettent aussi d’accepter ou de rejeter ce bloc : vous pouvez donc préparer seulement certaines lignes lorsqu’elles appartiennent à un bloc sélectionnable. Un fichier indexé peut être désindexé avant le commit.

Dans le composeur, saisissez un sujet concis puis, si nécessaire, un corps séparé. Vérifiez la sélection indexée et lancez Commit. Seuls les changements indexés sont enregistrés ; les autres restent dans l’arbre de travail.

Récupérer (Fetch) télécharge les références distantes et actualise les compteurs, sans modifier vos fichiers. Actualiser (Pull) récupère puis intègre la branche amont dans la branche courante. Publier (Push) envoie les commits locaux vers la destination configurée ; si plusieurs dépôts distants existent, choisissez la cible proposée.

Le menu d’actions supplémentaires propose aussi Pull (rebase), qui rejoue vos commits locaux au-dessus des commits récupérés. Attendez la fin d’une opération avant d’en lancer une autre et résolvez tout conflit signalé par Singularity.

Choisissez Mettre toutes les modifications de côté pour nettoyer temporairement l’arbre de travail sans créer de commit. Singularity inclut les fichiers suivis, indexés et non suivis dans la remise et lui donne un message de travail en cours lié à la branche.

Appliquer la dernière remise restaure la remise la plus récente puis la retire de la pile, comme git stash pop. Si son application crée des conflits, la remise n’est pas perdue : résolvez-les avant de poursuivre.

Ces commandes sont destructives. Abandonner les modifications d’un fichier restaure sa version suivie et ne peut pas être annulé. Supprimer les fichiers non suivis efface les nouveaux fichiers et dossiers sélectionnés ; comme Git n’en possède aucune copie, cette suppression est irréversible.

Tout abandonner restaure depuis HEAD les fichiers indexés et modifiés, réinitialise les sous-modules suivis, supprime les nouveaux fichiers et les dépôts imbriqués, puis abandonne toute fusion ou rebase en cours. Les changements éventuellement restaurés par l’autostash de cet abandon sont eux aussi supprimés définitivement. Cette action est irréversible. Relisez la confirmation avant de la valider.

Depuis un fichier du cockpit, ouvrez son menu contextuel puis choisissez Historique du fichier. La liste présente les commits qui ont touché ce chemin. Sélectionnez un commit pour afficher ses fichiers, puis le fichier voulu pour lire le diff entre cette révision et sa version précédente.

Le diff distingue ajouts et suppressions et conserve le contexte autour des blocs modifiés. L’historique est une consultation : il ne modifie ni la branche courante ni l’arbre de travail.