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 est une plateforme basée sur Git, qui vous permet d’enregistrer vos projets Git dans le cloud et de collaborer 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écouverte des bases de Git avec GitHub Desktop

Pour les opérations Git standard, nous recommandons GitHub Desktop, une application qui vous permet d’interagir avec Git visuellement au lieu de passer par 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

Si vous utilisez GitHub Desktop pour la première fois, vous devez l’installer et connecter votre compte GitHub.

1. Téléchargez GitHub Desktop.
2. Ouvrez GitHub Desktop, puis cliquez sur Se connecter à GitHub.com et autorisez GitHub Desktop à accéder à votre compte.
3. De retour dans GitHub Desktop, cliquez sur Terminer. Votre nom et votre adresse e-mail de votre compte GitHub seront ainsi ajoutés à 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 référentiel sur votre lecteur local.

2. Nommez le référentiel .

3. Sélectionnez d'initialiser ce référentiel avec un fichier README pour créer automatiquement un fichier vide.

   Conseil

   Il est courant d’inclure un fichier, également appelé Lisez-moi, 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. Créons maintenant un dépôt 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 afficher votre dépôt distant, cliquez sur Afficher 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 , 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 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 Branche actuelle, puis cliquez sur Nouvelle branche.
2. Nommez votre nouvelle branche , 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. En fait, vous avez déjà effectué votre premier commit : lorsque vous avez initialisé votre projet avec un fichier LISEZMOI, GitHub Desktop a automatiquement créé ce premier commit qui a ajouté le 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 et enregistrez vos modifications :

   Markdown

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

3. Une fois de retour dans GitHub Desktop, vous pourrez voir les modifications que vous avez apportées à votre README. En bas à gauche, à côté de votre photo de profil GitHub, tapez « Mettre à jour le 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 effectuer votre commit, cliquez sur Valider les mises à jour du fichier README.

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 un "pull request" qui intègre les modifications que nous avons apportées à dans notre branche d'origine, .

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

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

3. Cliquez sur Créer une requête de tirage.

4. Dans la fenêtre GitHub qui apparaît, modifiez le titre de votre pull request en « Ajouter un message au fichier README », puis rédigez une courte description de vos modifications dans la zone de commentaire.

5. Cliquez sur Créer une demande de pull.

6. Pour intégrer vos modifications dans la branche, en bas de la page, cliquez sur Fusionner la requête de tirage (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 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 , 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 branche, sélectionnez le menu déroulant Branche actuelle, puis cliquez sur principal.

   Vous devez presque toujours revenir à la branche 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 distante, cliquez sur Récupérer l'origine.

3. Enfin, pour mettre à jour votre branche locale avec les modifications de la branche distante, cliquez sur Pull d’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 GitHub CLI, qui vous permet d’effectuer rapidement des actions liées à GitHub à partir de la ligne de commande.

4. Pour vous authentifier auprès de GitHub à partir de GitHub CLI, exécutez la commande suivante :

   Shell

   gh auth login
   

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

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

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 quelque chose 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 qu'il fournit un historique détaillé d’un fichier, précisant l’auteur et le commit qui ont 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 :

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 demande quel type de commande vous recherchez, utilisez vos touches de direction pour choisir commande git, puis appuyez sur Entrée. Copilot suggérera alors 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 et le commit qui ont modifié la dernière fois la ligne 1 de.

Revue et étapes suivantes

Dans cet article, nous avons abordé les bases 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 : une capture instantanée de votre projet à un moment donné.
• Branche : copie de votre projet sur laquelle vous pouvez travailler sur un ensemble de modifications.
• Pull request : une demande de fusion des modifications d’une branche vers une autre.

Nous avons également parlé de la réalisation d’opérations Git plus complexes sur la ligne de commande. Nous avons expérimenté des outils et des logiciels pour comprendre et découvrir de nouvelles commandes et fonctionnalités.

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