{{tag>git dev 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%%:

<code bash>
$ git config --global alias.st "status -s"
</code>

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 '**!**':

<code bash>
$ git config --global alias.visual "!gitk"
</code> 

<note>
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.
</note>

===== Lister les alias =====

Les alias sont définis dans la configuration, pour lister les alias existants:
<code bash>
git config --global | grep alias
</code>

===== 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

<code bash>
 git config --global alias.lg "log --graph --oneline --all --decorate"
</code>


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

<code bash>
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 ""'
</code>

{{git_log_graphe_01.png}}