gitk

gitk peut être un outil d'apprentissage utile pour ceux qui découvrent le contrôle de version, ou ceux qui migrent depuis un autre système de contrôle de version comme Subversion. C'est un utilitaire pratique qui est fourni avec le noyau Git. Il fournit une interface utilisateur graphique qui aide à la visualisation de la mécanique interne de Git. D'autres interfaces graphiques Git populaires sont git-gui et Sourcetree d'Atlassian.

Limitez les commits à un chemin de fichier spécifique. Pour isoler les chemins des noms de version, utilisez « -- » afin de séparer les chemins des options précédentes.

Affiche toutes les branches, tous les tags et toutes les réfs.

Displays the selected item (branches, tags, remotes) as if they were mainline commits. When ＜pattern＞ is passed, further limits refs to ones matching the specified pattern

Permet d'afficher le rendu des commits plus anciens que la date spécifiée.

Permet de trier les commits par date.

Permet d'afficher les commits qui modifient les fichiers en conflit identifiés lors d'un merge.

Affiche des étiquettes informatives qui indiquent de quel côté d'un diff proviennent les commits. Les commits du côté gauche sont préfixés par un symbole < et ceux de droite, par un symbole >.

Lorsqu'on lui donne une plage de commits à afficher (par exemple, commit1..commit2 ou commit2 commit1), affiche uniquement les commits qui existent directement sur la chaîne d'ascendance entre commit1 et commit2, c'est-à-dire les commits qui sont à la fois des descendants de commit1 et des ancêtres de commit2 (voir « Simplification de l'historique » dans git-log(1) pour une explication plus détaillée).

Des options puissantes qui vous permettent de suivre l'historique d'une plage de numéros de ligne de code donnée.

Afin de fournir une sortie utile, gitk a besoin d'un dépôt sous-jacent avec un historique commité. Le code suivant est une séquence de commandes bash qui créeront un dépôt avec deux branches qui comportent des commits et qui ont été mergées en une seule.

Ce dépôt de démo sera un bon exemple à explorer avec gitk. Cette séquence de commandes crée un dépôt avec 1 commit et un fichier index.txt. Appelons maintenant la commande gitk pour examiner le dépôt.

Continuons avec notre dépôt de démo et créons maintenant un commit supplémentaire :

Une fois les commandes en cours exécutées, gitk devra être rechargé. Rechargez gitk à partir de la ligne de commande, ou utilisez l'interface graphique et accédez à Fichier -> Recharger. Une fois rechargé, nous devrions voir notre nouveau commit.

Nous pouvons voir que la réf de la branche main pointe maintenant vers le nouveau commit. Pour comparer ces deux commits, nous utilisons le panneau d'historique en haut à gauche. Dans le panneau d'historique, cliquez sur un commit qui sera la base de la comparaison. Une fois le premier commit sélectionné, cliquez avec le bouton droit de la souris sur un deuxième commit pour ouvrir un menu contextuel.

Ce menu contextuel propose les options suivantes :

Lorsque vous sélectionnez l'une de ces options, une différence entre les deux commits apparaît dans le volet inférieur gauche, ce qui, dans notre exemple, ressemble à ceci :

La sortie du diff nous montre que index.txt avait une nouvelle ligne « prepended content to index » entre les deux commits.

Continuons avec notre exemple de dépôt et créons une branche.

La séquence de commandes suivante créera une branche nommée new_branch et y ajoutera le fichier new_branch_file.txt. En outre, un nouveau contenu est ajouté au fichier index.txt, et un commit supplémentaire est effectué pour cette mise à jour. Nous avons maintenant une nouvelle branche qui a 2 commits d'avance sur main. Nous devons recharger gitk pour faire apparaître ces changements.

Discuter du mécanisme de création de branches dans Git est une excellente occasion pour apprendre. gitk affiche les commits sous la forme d'une séquence linéaire de commits. Le terme « branche » implique que nous devons nous attendre à une branche ou un fork dans la chronologie. Les branches dans Git sont différentes des autres systèmes de contrôle de version. Dans Git, une branche correspond à un pointeur vers un commit. Le pointeur se déplace vers les commits au fur et à mesure qu'ils sont créés. Lorsque vous créez une commande git branch, vous ne changez rien à la structure du dépôt ou de l'arborescence source. Vous créez simplement un pointeur.

Afin de comparer les commits qui diffèrent entre les deux branches, gitk doit être lancé avec une plage de révisions spécifiée. L'exécution de gitk main..new_branch ouvrira gitk avec uniquement les commits entre les deux réfs de branche.

Il s'agit d'un puissant utilitaire pour comparer des branches.

Git Gui est une autre interface utilisateur graphique basée sur Tcl/Tk pour Git. Alors que gitk se concentre sur la navigation et la visualisation de l'historique d'un dépôt, Git Gui se concentre sur le perfectionnement de chaque commit, sur l'annotation d'un fichier unique et ne montre pas l'historique du projet. Git Gui fournit également des options de menu pour lancer gitk et explorer l'historique. Git Gui est également appelé en exécutant la commande git gui à partir de la ligne de commande.

En conclusion, gitk est un encapsuleur d'interface graphique pour git log. Il est incroyablement puissant pour visualiser et explorer l'historique d'un dépôt. gitk est également un outil utile pour apprendre les mécanismes internes de Git.