Git Show

git-show est un utilitaire de ligne de commande utilisé pour afficher des détails supplémentaires sur les objets Git, comme les blobs, les arborescences, les tags et les commits. git-show adopte un comportement spécifique en fonction du type d'objet.

Les tags montrent le message de tag et d'autres objets inclus dans le tag. Les arborescences spécifient les noms et le contenu des objets qu'elles contiennent. Les blobs affichent leur contenu direct. Les commits indiquent le message de journal de commit et une sortie diff des changements apportés dans le commit.

Les objets Git sont tous accessibles par des références. Par défaut, git-show va à l'encontre de la référence HEAD. Cette dernière pointe toujours vers le dernier commit de la branche actuelle. Vous pouvez donc utiliser git-show pour afficher le message de journal et la sortie diff du tout dernier commit.

--oneline
Il s'agit d'un raccourci pour utiliser la commande étendue --pretty=oneline --abbrev-commit

--encoding[=＜encoding＞]
L'encodage de caractères sur les messages de journaux Git est défini par défaut sur UTF-8. L'option d'encodage peut être changée en une sortie d'encodage de caractères différente. C'est pratique si vous travaillez avec Git dans un environnement utilisant différents encodages de caractères, comme un terminal en langue asiatique.

＞--expand-tabs=＜n＞
--expand-tabs
--no-expand-tabs
Ces options remplacent les caractères de tabulation par des espaces dans la sortie du message du journal. La valeur n peut être définie pour configurer le nombre de caractères d'espacement correspondant à la taille des tabulations. Sans valeur n explicite, les tabulations correspondront à 8 espaces. --no-expand-tabs est équivalent à n=0

--notes=＜ref＞
--no-notes
Git dispose d'un système de notes qui permet d'attacher des métadonnées de « notes » arbitraires aux objets. Ces données peuvent être cachées ou filtrées lors de l'utilisation de git-show.

--show-signature
Cette option valide que le commit est signé avec une signature chiffrée en le transmettant à une sous-commande gpg.

L'option --pretty présentée ci-dessus accepte plusieurs options secondaires pour manipuler le format de la sortie git-show. Ces options secondaires sont répertoriées ci-dessous avec l'exemple de modèle :

• oneline
  ＜sha1> ＜ligne de titre>

Oneline tente de comprimer autant d'informations que possible en une seule ligne

• short
  commit ＜sha1＞
Author: ＜auteur＞
＜ligne de titre＞

• medium
  commit ＜sha1＞
Author: ＜auteur＞
Date: ＜date création＞
＜ligne de titre＞
＜message commit complet＞

• full
  commit ＜sha1＞
Author: ＜auteur＞
Commit: ＜committeur＞
＜ligne de titre＞
＜message commit complet＞

• fuller
  commit ＜sha1＞
Author: ＜auteur＞
AuthorDate: ＜date création＞
Commit: ＜committeur＞
CommitDate: ＜date commit＞
＜ligne de titre＞
＜message commit complet＞

• email
  From ＜sha1＞ ＜date＞
From: ＜auteur＞
Date: ＜date création＞
Subject: [PATCH] ＜ligne de titre＞
＜message commit complet＞

• raw
  Le format raw ignore les autres options de formatage direct transmises à git-show et génère le commit exactement comme il est enregistré dans l'objet. L'option raw ignorera --abrev et --no-abbrev, et affichera toujours les commits parent.

• format :
  format permet de spécifier un format de sortie personnalisé. Il fonctionne de la même manière que la commande printf en langage C. L'option --pretty=format prend une valeur secondaire d'une chaîne de modèle. Le modèle a accès à des variables d'espace réservé, qui seront remplies avec les données de l'objet de commit. Ces espaces réservés sont énumérés ci-dessous :
  
  • %H : empreinte du commit
  • %h : empreinte abrégée du commit
  • %T : empreinte de l'arborescence
  • %t : empreinte abrégée de l'arborescence
  • %P : empreintes des parents
  • %p : empreintes abrégées des parents
  • %an : nom de l'auteur
  • %aN : nom de l'auteur
  • %ae : e-mail de l'auteur
  • %aE : e-mail de l'auteur
  • %ad : date de création (format respecté : --date= option)
  • %aD : date de création, style RFC2822
  • %ar: date de création, relative
  • %at : date de création, horodatage UNIX
  • %ai : date de création, format ISO 8601
  • %cn : nom du commiteur
  • %cN : nom du commiteur
  • %ce : e-mail du commiteur
  • %cE : e-mail du commiteur
  • %cd : date du commit
  • %cD : date du commit, style RFC2822
  • %cr : date du commit, relative
  • %ct : date du commit, horodatage UNIX
  • %ci : date du commit, format ISO 8601
  • %d : noms de réf, identique à l'option --decorate de git-log(1)
  • %e : encodage
  • %s : objet
  • %f : ligne d'objet nettoyée, adaptée pour un nom de fichier
  • %b : corps
  • %N : notes de commit
  • %gD : sélecteur reflog, p. ex., refs/stash@{1}
  • %gd : sélecteur reflog abrégé, p. ex., stash@{1}
  • %gs : objet du reflog
  • %Cred : remplace la couleur par rouge
  • %Cgreen : remplace la couleur par vert
  • %Cblue : remplace la couleur par bleu
  • %Creset : réinitialise la couleur
  • %C(...) : spécification de couleur, comme décrit dans l'option de configuration color.branch.*
  • %m: à gauche, à droite ou à la limite
  • %n : nouvelle ligne
  • %% : un pourcentage brut
  • %x00 : imprime un octet d'un code hexadécimal
  • %w([[,[,]]]) : change l'encapsulation de la ligne, comme l'option -w de git-shortlog

Cette commande permet de répertorier tous les fichiers touchés dans un commit

Cette commande affiche une version spécifique du fichier. Remplacez REVISON par une empreinte SHA Git.

Cela affiche le tag v2.0.0 et le commit à 6ef002d74cbbc099e1063728cab14ef1fc49c783

Cela génère tous les commits dans la plage comprise entre commitA et commitD

git-show est une commande très polyvalente pour examiner des objets dans un dépôt Git. Elle peut être utilisée pour cibler des fichiers donnés à des révisions spécifiques. Examiner une plage de commits à l'aide de la commande git-show génère tous les commits individuels de cette plage. git-show peut s'avérer utile pour créer des notes de patch et suivre les changements dans un dépôt.