Configuration de Git : le guide ultime

Git est un outil gratuit et open source, avant tout un système de gestion de versions distribué. Il permet de suivre et d’organiser les différentes versions d’un projet, par exemple d’un code source. Il existe de nombreux logiciels de gestion de versions (Subversion, Bazaar, etc.), mais Git est aujourd’hui le plus populaire et le plus utilisé pour suivre l’évolution du code.

L’intérêt principal d’un système de gestion de versions est de tracer précisément les différentes étapes d’un projet. Il facilite aussi la collaboration au sein d’une équipe. Lorsque plusieurs personnes travaillent sur le même projet et doivent résoudre des problèmes communs, la gestion de versions devient essentielle : elle permet de savoir « qui a fait quel changement », « pourquoi ce changement a été fait », « quand a-t-il eu lieu », etc.

Il existe de nombreux IDE pour Python, et vous pouvez y intégrer Git à votre projet. Pour choisir un IDE, consultez ce tutoriel : Top 5 Python IDEs for Data Science. Pour une configuration complète, Datacamp propose aussi un bref tutoriel : Top 5 IDES.

Télécharger Git sous Windows :

1. Rendez-vous sur le site de Git : Git Download
2. Téléchargez la version adaptée à votre édition de Windows.
3. Installez Git en conservant les options par défaut recommandées.

Une fois ces étapes terminées, vous pouvez exécuter git en ligne de commande. Vous verrez alors s’afficher des informations utiles, notamment l’aide et les commandes Git les plus courantes.

Git propose différents niveaux de configuration, au nombre de trois :

1. Système
2. Global
3. Dépôt

On peut considérer ces niveaux comme hiérarchisés : Système est le niveau le plus élevé, Global vient ensuite, et Dépôt est le niveau le plus bas. Un même paramètre peut être défini à plusieurs niveaux ; si, par exemple, user.email est défini au niveau Dépôt, il masque la valeur définie au niveau Global. De même, une valeur définie au niveau Global masque celle définie au niveau Système.

Git dispose de la commande config, qui accepte des paramètres ainsi que des arguments indiquant le niveau de configuration à utiliser.

1. Niveau système (--system) : couvre l’ensemble des utilisateurs, de la machine et de tous les dépôts. Sous Windows, le fichier de configuration se trouve dans C:\Documents\Git\etc\gitconfig. Toute modification à ce niveau s’applique partout, c’est-à-dire à chaque dépôt. C’est pourquoi il est souvent déconseillé d’éditer la configuration au niveau système.

2. Niveau global (--global) : la configuration à ce niveau s’applique à l’utilisateur de l’OS. Sous Windows, elle est stockée dans C:\Users\<UserName>\.gitconfig.

3. Niveau dépôt (--local)

Le niveau Dépôt est spécifique à chaque dépôt. Par exemple, si vous clonez un projet depuis GitHub, Git écrira par défaut la configuration au niveau local lorsqu’aucun niveau n’est précisé. Le fichier de configuration se trouve dans le sous-dossier du dépôt .git. Sous Windows : C:\<RepoFolder>\.git\config.

Configuration de base

Vous pouvez exécuter les commandes ci-dessous dans l’invite de commandes pour améliorer votre expérience.

Vérifier la version de Git

git --version

Configurer votre nom

git config --global user.name "<Your-Full-Name>"

Configurer votre adresse e-mail

git config --global user.email "<your-email-address>"

Activer la coloration de la sortie

git config --global color.ui auto

Afficher l’état initial lors d’un conflit

git config --global merge.conflictstyle diff3

Lister la configuration actuelle

git config --list

Pour en savoir plus, consultez : Git Configuration.

Git avec un éditeur de code

Vous pouvez utiliser Git avec l’éditeur (IDE) de votre choix. De nombreux éditeurs populaires existent ; cherchez simplement la procédure correspondant à votre environnement.

Configuration de Sublime Text :

git config --global core.editor "'C:/Program Files/Sublime Text 2/sublime_text.exe' -n -w"

Configuration de VSCode :

git config --global core.editor "code --wait"

Configuration de l’éditeur Atom :

git config --global core.editor "atom --wait"

Télécharger Git sur macOS/Linux :

1. Rendez-vous sur le site de Git : Git Download
2. Téléchargez la version adaptée à macOS ou Linux.
3. Installez Git en conservant les options par défaut recommandées.

Une fois ces étapes terminées, vous pouvez exécuter git dans le terminal. Vous verrez alors s’afficher des informations utiles, notamment l’aide et les commandes Git les plus courantes.

Git propose différents niveaux de configuration, au nombre de trois :

1. Système
2. Global
3. Dépôt

Ces niveaux sont hiérarchisés : Système est le plus élevé, Global vient ensuite, et Dépôt est le plus bas. Un même paramètre peut être défini à plusieurs niveaux ; si, par exemple, user.email est défini au niveau Dépôt, il masque la valeur définie au niveau Global, et une valeur au niveau Global masque celle du niveau Système.

La commande config de Git accepte des paramètres ainsi que des arguments pour préciser le niveau de configuration à utiliser.

1. Niveau système (--system) : couvre l’ensemble des utilisateurs, de la machine et de tous les dépôts. Sous Linux, le fichier de configuration se trouve dans /etc/gitconfig. Sous macOS, il se trouve dans /usr/local/git/etc/gitconfig. Les changements effectués à ce niveau affectent tous les dépôts. Il est donc souvent déconseillé de modifier la configuration système. De plus, cela requiert des privilèges administrateur (root) sous macOS et Linux.

2. Niveau global (--global) : la configuration s’applique à l’utilisateur courant du système d’exploitation. Sous Linux comme sous macOS, elle est stockée dans ~/.gitconfig.

3. Niveau dépôt (--local)

Le niveau Dépôt est propre à chaque dépôt. Par exemple, si vous clonez un projet depuis GitHub, Git écrit par défaut la configuration au niveau local lorsqu’aucun niveau n’est spécifié. Le fichier de configuration se trouve dans le sous-dossier .git du dépôt. Sous Linux et macOS : ~/<MyRepoFolder>/.git/config.

Configuration de base

Exécutez les commandes suivantes dans le terminal pour une configuration optimale.

Configurer votre nom

git config --global user.name "<Your-Full-Name>"

Configurer votre adresse e-mail

git config --global user.email "<your-email-address>"

Activer la coloration de la sortie

git config --global color.ui auto

Afficher l’état initial lors d’un conflit

git config --global merge.conflictstyle diff3

Lister la configuration actuelle

git config --list

Git avec un éditeur de code

Configuration de Sublime Text

git config --global core.editor "'/Applications/Sublime Text 2.app/Contents/SharedSupport/bin/subl' -n -w"

Configuration de VSCode

git config --global core.editor "code --wait"

Configuration de l’éditeur Atom

git config --global core.editor "atom --wait"

Conclusion

Dans ce tutoriel, vous avez appris à installer Git sur différents systèmes d’exploitation. Vous avez également vu la configuration de base pour l’utiliser avec vos IDE préférés et compris les différents niveaux de configuration dans Git.

Voici quelques ressources pour approfondir votre maîtrise de Git :

 1. Getting Git Right

 2. Git Basics

Pour aller plus loin, suivez le cours de DataCamp : Introduction to Git For Data Science.