Outils pour utilisateurs

Outils du site


dev:git:alias

Les alias sous git

Les alias permettent de définir de nouvelles commandes git à partir de commandes existantes accompagnées des options souhaitées ou en appelant des commandes externes à git.

Créer un alias

Dans l'exemple ci-dessous on définit un alias en modifiant la configuration globale via l'argument --global:

$ git config --global alias.st "status -s"

Après cette définition, invoquer git st appellera la commande git status -s.

Pour qu'un alias lance un exécutable quelconque externe à git préfixer par le caractère '!':

$ git config --global alias.visual "!gitk"
Les alias créées avec l'option --global sont enregistrés dans le fichier de configuration de l'utilisateur ~/.gitconfig et sont disponibles pour tous les dépots.

Lister les alias

Les alias sont définis dans la configuration, pour lister les alias existants:

git config --global | grep alias

Exemples d'alias

Afficher les log sous forme d'arborescence: une ligne par commit, toutes les branches, l'option --decorate affiche les références

 git config --global alias.lg "log --graph --oneline --all --decorate"

Affiche un historique sous forme de graphe personnalisé intégrant des couleur et un format d’horodatage court à la française:

git config --global alias.lg '!git --no-pager log --pretty=format:"%C(auto)%h%d - %s %C(#808080)[%ad] %Creset" --graph --all --date=format:"%d/%m/%y %H:%M"; echo ""'

dev/git/alias.txt · Dernière modification : 2023/09/19 10:33 de yoann