~2 min de lecture
Une belle façon d'afficher son historique (git)
Ce contenu a été traduit de l'anglais vers le français à l'aide de Claude.
Aujourd'hui, on va parler de git log !
Si seule la commande vous intéresse, vous pouvez scroller un peu ;)
Une courte introduction
Je sais qu'il existe plein d'outils pour afficher votre index git (blade, kraken... jetez un œil à la liste ici). Croyez-le ou non, je n'en ai jamais utilisé un seul.
Enfin... pour être honnête, c'est un mensonge :p. En fait, j'en ai essayé 2 ou 3, mais aucun ne m'a autant satisfait que le terminal.
Vous allez sans doute me dire que travailler uniquement avec le terminal est carrément galère - voire impossible, et que les logiciels graphiques ont justement été conçus pour vous simplifier la vie, mais je ne suis pas d'accord - il suffit de voir comment j'utilise vim en guise d'IDE pour avoir une idée de ma façon de faire les choses ahah.
Bien sûr, ce n'est pas toujours vrai - généraliser est une mauvaise idée ! Mais on va dire que si, pour les besoins de cet article !
Plus tard, je ferai un autre article sur le « pourquoi il faut toujours apprendre à faire les choses via le terminal » ~ une règle que j'aime bien ~ mais pas maintenant.
Revenons-en au sujet !
La commande git log affiche l'historique de la branche sur laquelle vous travaillez. Autrement dit, « qui a fait quoi, quand » - une sorte de 3w bien à nous ;)
Avec 4 à 6 options supplémentaires, on va transformer cet affichage disgracieux en quelque chose de superbe.
Voici la commande :git log --all --decorate --graph --oneline [--color] [--simplify-by-decoration]
Et maintenant, quelques explications sur les options :
- all -> affiche toutes les branches, tous les commits etc. En clair, demande « l'historique git complet » plutôt que « juste la branche actuelle »
- decorate -> affiche des infos utiles comme le
HEAD, les tags etc - graph -> restitue le résultat sous forme de graphe
- oneline -> rend l'historique plus facile à lire car plus court (un commit sera littéralement rendu sur « une seule ligne »)
- color -> 99% du temps votre terminal/config aura la couleur activée par défaut... les 1% restants, vous aurez besoin de cette option ;)
- simplify-by-decoration -> utile seulement si votre historique est complètement en bazar et que vous avez besoin d'une vue d'ensemble de l'arbre de travail
Vous pouvez jouer avec, ajouter ou retirer des options pour voir les différences.
En bref
Je vous recommande FORTEMENT de l'apprendre (sans faire d'alias ni tricher d'une quelconque manière) - même si apprendre à lire le graphe peut prendre un peu de temps.
Ça en vaudra clairement la peine. J'ai fait un article dédié pour expliquer « comment l'apprendre », la bonne méthode.