Objectifs

Pratiquer Git avec les outils suivants :

  • RStudio
  • la ligne de commande
  • VS Code

Présentation de Git

Présentation de Git

  • Créé en 2005 par Linus Torvalds (créateur de Linux)
  • Logiciel libre de gestion de versions
  • Principale tâche : gérer l’évolution du contenu d’une arborescence
  • Gère les différents états d’un code au cours du temps

Comment utiliser Git ?

  • Logiciel client à installer sur le poste (installateur Git)
  • Interaction par une interface graphique ou en ligne de commande
  • Git intégré ou intégrable aux IDE (Eclipse, RStudio, VS Code…)

Du code ?

À quoi sert Git ?

À quoi sert Git ?

  • Suivi et sauvegarde des changements dans le code
  • Mise à disposition / partage
  • Mise en place des outillages logiciels (vérifications automatiques, empaquetage…)

Bénéfices en général

  • Traçabilité des modifications
  • Retour à une version antérieure, reproductibilité
  • Copie de travail locale (pour un travail hors ligne)
  • Synchronisation entre plusieurs postes, accessibilité (session 2)
  • Travail sur des questions en parallèle (session 3)

Cas d’utilisation

Pourquoi aurait-on besoin de Git ?

  • Modifier son code et vouloir faire marche arrière
  • Maintenir plusieurs versions du code
  • Comparer 2 versions du même code
  • Suivre les changements sur mes fichiers
  • Parcourir l’historique d’un bout de code

États

Les états du système de fichiers

États (session 1)

  • Working directory : dossier de travail
  • Stage : index pour tracer les modifications qui seront validées
  • Repo : ensemble des fichiers (les vôtres et ceux de Git)
  • HEAD : pointeur identifiant le dernier commit

Premières pratiques en local

Généralement, les diapos seront construites avec 3 onglets permettant de faire le lien avec les outils suivants :

  • en ligne de commande
  • avec RStudio
  • avec VS Code

Un logo est présent sur chaque diapo pour rappeler de quel mode il s’agit.

Installation de Git

Installation des interfaces

  • Installation automatique de l’interface graphique Git-Gui (fiche aide)
  • Possibilité d’installer d’autres interfaces graphiques GUI Clients (attention à la maintenance des outils)
  • Interface client (intégrée à l’explorateur de fichiers) : tortoisegit

Important

Nous ne parlerons pas de l’interface graphique Git-Gui directement installée au moment du téléchargement de Git.

D’abord installer R :

Puis RStudio :

Paramétrage de Git

Ouvrir un terminal et saisir les commandes en les adaptant :

  • dans RStudio : Tools > Terminal > New terminal
  • dans VS Code : Terminal > New terminal
# Définir votre identité qui sera associée à vos validations Git
git config --global user.email "you@example.com"
git config --global user.name "Your Name"
# En avance pour la Session 2, définir le nom de la branche principale en accord avec la forge et les derniers usages
git config --global init.defaultBranch main

Opérations de bases

Prérequis : disposer d’un dossier dans lequel on peut écrire.

Pour un dossier vide, on crée un dossier “mon_projet” :

cd
mkdir mon_projet

Pour un dossier contenant déjà des fichiers, on se place dans le dossier :

cd mon_projet

Prérequis : travailler dans un projet RStudio (Documentation RStudio).

Créer un projet

Ouvrir un projet existant

Prérequis : disposer d’un dossier dans lequel on peut écrire

Démarrage de VS Code sur un dossier vide :

Démarrage de VS Code sur un dossier existant :

cd mon_projet
code .

Initialisation d’un dépôt Git − Ligne de commande

Initialiser un dépôt Git “local” pour suivre les fichiers du dossier “mon_projet” :

cd mon_projet
git init .

Un dossier .git est créé dans mon_projet. C’est là que Git stocke les informations dont il a besoin.

Consulter son contenu dans un terminal

Ne pas essayer d’éditer les fichiers du dossier .git.

Initialisation d’un dépôt Git − RStudio

Lors de la création d’un projet :

Menu Tools > Version Control > Project Setup…

Choisir “git” dans le menu “Version control system”

Ou lancer la commande git init dans le terminal.

Après actualisation de RStudio, Git est désormais intégré à RStudio.

Ne pas essayer d’éditer les fichiers du dossier .git.

Initialisation d’un dépôt Git − VS Code

Dans VS Code, sur le dossier à suivre :

  • ouvrir l’outil “Source Control”
  • cliquer sur le bouton “Initialize repository”

Un dossier .git est créé, c’est là que Git stocke les informations dont il a besoin.

Contrôler en ouvrant un terminal et en vérifiant la présence d’un dossier .git.

Ne pas essayer d’éditer les fichiers du dossier .git.

Pratique

Création d’un dépôt Git local

  1. Créer un dossier “mon_projet”
  2. En choisissant votre éditeur préféré ou simplement la ligne de commande, initialiser Git sur ce dossier
  3. Parcourir l’arborescence et constater qu’un dossier .git a été créé

Consultation état du dépôt

Il est souvent très utile de faire le point sur les évolutions en cours :

  • identifier les fichiers qui ont changé
  • identifier ceux qui sont dans l’index et en attente de validation
  • vérifier la branche de développement en cours (session 3)
  • …

Il s’agit donc de connaître le statut du dépôt.

Important

Cette commande est importante à assimiler. Au moindre doute, on doit avoir le réflexe de l’utiliser !

Consultation état du dépôt

Pour vérifier l’état du dépôt :

git status

On obtient la liste :

  • des nouveaux fichiers
  • des fichiers modifiés

L’onglet Git de RStudio vous permet de connaître l’état du dépôt rattaché à votre projet :