Bien démarrer avec Git

Vous est-il déjà arrivé de rêver d’avoir une machine à remonter le temps pour votre code ? Eh bien, grâce à Git, ce rêve devient réalité, et bien plus encore !

Si vous ne connaissez pas encore Git, il s’agit d’un système de contrôle de version qui vous aide à suivre les modifications apportées à votre code. Vous pouvez enregistrer un instantané de votre projet à un moment précis, puis effectuer des modifications expérimentales sans risquer de perdre votre travail, car vous pouvez toujours revenir à votre instantané.

GitHub elle-même est une plateforme basée sur Git, ce qui vous permet d’enregistrer vos projets Git dans le cloud et de travailler dessus avec d’autres développeurs.

Même si Git peut sembler compliqué, il s’agit d’un outil puissant et indispensable pour tout développeur. Cet article vous donnera tous les outils dont vous avez besoin pour utiliser Git dans votre flux de travail quotidien.

Prérequis

Pour suivre ce tutoriel, vous devez installer Visual Studio Code.

Découvrir les principes de base de Git avec GitHub Desktop

Pour les opérations Git standard, nous vous recommandons GitHub Desktopd’utiliser une application qui vous permet d’interagir visuellement avec Git au lieu d’utiliser des commandes écrites. Dans cette section, nous allons apprendre à utiliser GitHub Desktop pour effectuer rapidement les opérations Git les plus courantes.

Configuration de GitHub Desktop

S’il s’agit de votre première utilisation GitHub Desktop, vous devez l’installer et connecter votre GitHub compte.

1. Télécharger GitHub Desktop.
2. Ouvrez GitHub Desktop, puis cliquez sur Se connecter à GitHub.com pour autoriser GitHub Desktop à accéder à votre compte.
3. De retour dans GitHub Desktop, cliquez sur Terminer. Cela ajoute votre nom et votre adresse e-mail de votre GitHub compte à Git.

Créer un référentiel local

Vous pouvez maintenant faire vos premiers pas dans Git en créant un référentiel. Considérez un référentiel comme un dossier de projet qui suit les modifications et stocke l’historique. Tout d’abord, nous allons créer un référentiel local :

1. Dans GitHub Desktop, cliquez sur Créer un dépôt sur votre lecteur local.

2. Nommez le référentiel learning-git.

3. Sélectionnez Initialiser ce référentiel avec un fichier LISEZ-MOI pour créer automatiquement un fichier README.md vide.

   Conseil

   Il est courant d’inclure un fichier README.md, également appelé LISEZMOI, dans vos projets. Les fichiers README présentent généralement des informations destinées à aider autrui à comprendre, configurer et exécuter votre projet.

4. Cliquez sur Créer un dépôt.

Création d’un dépôt distant

Le référentiel local que vous venez de créer se trouve sur votre ordinateur. Maintenant, nous allons créer un référentiel distant pour le même projet, qui sera hébergé sur GitHub. La liaison à un dépôt distant facilite la collaboration et la sauvegarde de votre travail.

1. Dans GitHub Desktop, cliquez sur Publier le référentiel.
2. Dans la fenêtre contextuelle qui apparaît, cliquez une nouvelle fois sur Publier le référentiel.
3. Pour voir votre dépôt distant, cliquez sur Voir sur GitHub.

Configuration d’un espace pour apporter des modifications

Maintenant que vous avez créé un référentiel, parlons des branches. Les branches sont essentiellement des copies de votre projet où vous pouvez tester des modifications sans compromettre la stabilité de votre travail existant.

Les référentiels sont automatiquement créés avec une branche main, que vous pouvez considérer comme la version stable et principale de votre projet. Par exemple, dans le référentiel d’un site web, la branche main correspond au site que les visiteurs peuvent voir.

Lorsque vous créez une nouvelle branche, vous créez un espace sécurisé pour travailler sur une nouvelle fonctionnalité sans affecter la version principale. Vous et vos collaborateurs pouvez utiliser différentes branches pour travailler simultanément sur plusieurs fonctionnalités.

Créons une branche pour travailler sur les modifications de notre référentiel :

1. Dans GitHub Desktop, sélectionnez le menu déroulant Current Branch, puis cliquez sur Nouvelle branche.
2. Nommez votre nouvelle branche readme-updates, puis cliquez sur Créer une branche.

Enregistrement des instantanés de votre projet

Pour enregistrer votre progression dans votre branche, vous effectuez un commit. Un commit est un instantané que vous prenez de votre projet à un moment précis. Vous avez déjà effectué votre première validation : lorsque vous avez initialisé votre projet avec un fichier README, GitHub Desktop vous avez créé automatiquement une validation initiale pour ajouter le README.md fichier.

Chaque fois que vous terminez une partie du travail que vous souhaitez sauvegarder, vous devez effectuer un commit. Après cela, vous pouvez toujours revenir à ce point précis, quel que soit le nombre de modifications que vous apporterez par la suite.

1. Dans GitHub Desktop, cliquez sur Ouvrir dans Visual Studio Code.

2. Dans VS Code, collez le texte suivant dans README.md et enregistrez vos modifications :

   Markdown

   Hello, World!
   
   This is a demo project for learning how to use Git.
   

3. De retour dans GitHub Desktop, vous verrez les mises à jour que vous venez d’effectuer dans votre fichier README. En bas à gauche, en regard de votre GitHub image de profil, tapez « Mettre à jour README » dans la zone de texte. C’est ce qu’on appelle un message de commit, et il vous aide à suivre les modifications que vous apportez à chaque commit.

4. Pour valider votre commit, cliquez sur Commit to readme-updates.

Intégration de vos modifications dans votre branche primaire

Lorsque vous êtes satisfait des modifications que vous avez apportées à une branche, vous pouvez publier votre branche dans le dépôt distant et créer une demande de tirage (pull request). Les pull requests vous permettent de passer en revue un ensemble de modifications proposées, puis de les fusionner d'une branche vers une autre. Dans notre cas, nous allons créer une pull request qui intègre les modifications que nous avons apportées dans readme-updates dans notre branche d'origine, main.

1. Cliquez sur Publier la branche pour envoyer (push) la branche readme-updates avec vos modifications vers le dépôt distant.

2. Pour passer en revue vos modifications suggérées, cliquez sur Prévisualiser la pull request.

3. Cliquez sur Créer une pull request.

4. Dans la fenêtre GitHub qui s’affiche, modifiez le titre de votre pull request en « Ajouter un message au fichier README », puis rédigez une brève description de vos modifications dans la zone de commentaires.

5. Cliquez sur Créer une requête d'extraction.

6. Pour intégrer vos modifications dans la branche main, en bas de la page, cliquez sur Fusionner la pull request.

   Remarque

   Lorsque vous travaillez sur un projet avec d’autres développeurs, il est courant qu’une autre personne passe en revue votre pull request avant qu’elle soit fusionnée.

7. En bas de la page, cliquez sur Supprimer la branche. La suppression des branches fusionnées dans main contribue à la propreté et à la facilité de navigation de votre référentiel.

Préparation pour effectuer d’autres modifications

Félicitations pour la fusion de votre première pull request ! Maintenant que vous avez réussi à intégrer vos modifications dans la branche main, vous devez suivre quelques étapes pour vous préparer à votre prochaine série de modifications :

1. Dans GitHub Desktop, si vous n’êtes pas sur la main branche, sélectionnez le menu déroulant Current Branch, puis cliquez sur principal.

   Vous devez presque toujours revenir à la branche main avant de créer une nouvelle branche, car les nouvelles branches sont créées sous forme de copies de la branche actuellement sélectionnée.

2. Pour vérifier si des modifications ont été apportées à votre branche main distante, cliquez sur Récupérer l’origine.

3. Enfin, pour mettre à jour votre branche locale main avec les modifications apportées à la branche distante main, cliquez sur Récupérer l'origine.

Vous disposez maintenant de toutes les compétences nécessaires pour configurer et utiliser Git sur un projet !

Approfondir l'utilisation de Git avec la ligne de commande

GitHub Desktop est conçu pour répondre à vos besoins Git quotidiens. Au fur et à mesure de votre progression en tant que développeur, vous serez probablement confronté à des situations inhabituelles où vous voudrez avoir plus de contrôle sur une opération Git ou aurez besoin d’utiliser des commandes plus complexes. Dans ces cas, vous devrez passer à l’utilisation de commandes Git écrites sur la ligne de commande.

Configuration de votre ligne de commande

Avant de commencer à travailler avec la ligne de commande, vous devez configurer quelques outils.

1. Dans GitHub Desktop, appuyez sur Ctrl+` pour ouvrir votre projet sur la ligne de commande.

2. Si vous utilisez Windows, installez Git. Pour macOS et Linux, Git est installé par défaut.

3. Installez le GitHub CLI, qui vous permet d’effectuer rapidement depuis la ligne de commande des actions liées à GitHub.

4. Pour vous authentifier à GitHub partir du GitHub CLI, exécutez la commande suivante :

   Shell

   gh auth login
   

   Choisissez de s’authentifier avec GitHub.com, puis suivez les invites à l’écran.

5. Installez CLI GitHub Copilot, afin de pouvoir utiliser Copilot à partir de la ligne de commande. Consultez « Installation du CLI GitHub Copilot ».

Expérimentation de commandes complexes

Maintenant que vous avez tout configuré, découvrez comment trouver et comprendre les commandes dont vous pourriez avoir besoin à l’avenir. Prenons l’exemple suivant : vous avez vu quelqu’un mentionner git blame en ligne, mais vous ne savez pas ce que cela fait. Essayez de demander à Copilot de l’expliquer avec la commande suivante :

gh copilot explain "git blame"

gh copilot explain "git blame"

Copilot nous indiquera que git blame fournit un historique détaillé d’un fichier, en indiquant l’auteur et le commit qui a modifié en dernier chaque ligne du fichier. Faites-en l’expérience avec la commande suivante :

git blame README.md

git blame README.md

Cet outil est particulièrement utile, bien que, comme vous pouvez l’imaginer, la responsabilité d’un fichier puisse devenir très longue. Supposons que seule la dernière modification apportée à une ligne spécifique d’un fichier vous intéresse. Vous pouvez demander à Copilot de générer la commande appropriée pour vous :

gh copilot suggest "Show me the blame for line 1 of README.md"

gh copilot suggest "Show me the blame for line 1 of README.md"

Lorsque Copilot vous demande quel type de commande vous recherchez, utilisez les touches de direction pour choisir commande git, puis appuyez sur Entrée. Copilot suggère ensuite la commande suivante :

git blame -L 1,1 README.md

git blame -L 1,1 README.md

Utilisez vos touches de direction pour choisir Exécuter la commande, puis appuyez sur Entrée. Vous verrez l’auteur, ainsi que la dernière ligne modifiée de README.md.

Revue et étapes suivantes

Dans cet article, nous avons abordé les principes de base de Git avec GitHub Desktop, en apprenant des termes importants comme :

• Référentiel : dossier qui enregistre toutes les modifications apportées aux fichiers de votre projet.
• Commit : instantané de votre projet à un moment précis.
• Branche : copie de votre projet sur laquelle vous pouvez travailler sur un ensemble de modifications.
• Demande de pull (pull request)  : une demande de fusion des modifications d’une branche dans une autre.

Nous avons également parlé de la réalisation d’opérations Git plus complexes sur la ligne de commande. Nous avons essayé gh copilot explain et gh copilot suggest pour comprendre et trouver de nouvelles commandes et fonctionnalités.

Maintenant, essayez d’appliquer ces connaissances à votre propre travail. Ajoutez Git à un projet existant en GitHub Desktop appuyant sur Ctrl+O (Windows/Linux) ou Command+O (Mac) et découvrez les avantages du contrôle de version vous-même !