Utilisation de GitHub Codespaces pour les demandes de tirage

Vous pouvez utiliser GitHub Codespaces dans votre navigateur web, ou dans Visual Studio Code pour créer des pull requests, examiner des pull requests et répondre aux commentaires de revue.

Dans cet article

L’utilisation d’un codespace pour travailler sur une pull request vous offre tous les avantages de GitHub Codespaces. Pour plus d’informations, consultez « Fonctionnalités de GitHub Codespaces ».

À propos des pull requests dans GitHub Codespaces

GitHub Codespaces vous offre de nombreuses fonctionnalités dont vous pourriez avoir besoin pour travailler avec les pull requests :

  • Créer une pull request - À l’aide du Terminal et des commandes Git ou de la vue « Contrôle de code source », vous pouvez créer des pull requests comme vous le feriez sur GitHub. Si le référentiel utilise un modèle de demande de tirage, vous pourrez l’utiliser dans la vue « Contrôle de source ».
  • Ouvrir une pull request – Vous pouvez ouvrir une pull request existante dans un codespace, à condition d'avoir accès au codespace et à la branche à fusionner.
  • Review a pull request : une fois que vous avez ouvert une demande de tirage dans un espace de code, vous pouvez utiliser la vue « GitHub Pull Request » pour ajouter des commentaires de révision et approuver des demandes de tirage. Vous pouvez également utiliser GitHub Codespaces pour afficher les commentaires de révision.

Ouverture d’une pull request dans Codespaces

  1. Sous le nom de votre référentiel, cliquez sur Demandes d’extraction.

  2. Dans la liste des pull requests, cliquez sur la pull request que vous souhaitez ouvrir dans Codespaces.

  3. Sur le côté droit de votre écran, cliquez sur Code.

  4. Dans l’onglet Codespaces , cliquez sur .

    Capture d'écran de la liste déroulante « Code » avec l'onglet « Codespaces » sélectionné. Le message « Aucun codespace » s'affiche. Le bouton Plus est mis en surbrillance.

    Un codespace est créé pour la branche de la pull request et s’ouvre dans votre éditeur par défaut pour GitHub Codespaces.

Examen d’une pull request dans Codespaces

  1. Avec l’éditeur par défaut défini sur Visual Studio Code ou sur Visual Studio Code pour le web, ouvrez la pull request dans un codespace, comme décrit dans Ouverture d’une pull request dans Codespaces plus haut dans cet article.

  2. Dans la barre d’activité, cliquez sur l’icône de pull request Git pour afficher le volet latéral « GitHub Pull Request ». Cette icône s'affiche uniquement dans l'Activity Bar lorsque vous ouvrez une pull request dans un codespace.

    Capture d'écran de la barre d'activité VS Code. Le pointeur de la souris se trouve au-dessus d'une icône affichant l'infobulle « GitHub Pull Request ».

    Si vous avez ouvert une demande de tirage dans un espace de code et que l’icône de demande de tirage n’est pas affichée dans la barre d’activité, vérifiez que vous êtes connecté à GitHub. Cliquez sur l’icône GitHub dans la barre d’activité, puis cliquez sur Se connecter.

    Capture d'écran de la barre latérale GitHub montrant le bouton « Se connecter ». L'icône GitHub dans la barre d'activité est mise en évidence avec un encadré orange.

  3. Pour examiner les modifications apportées à un fichier précis, cliquez sur le nom du fichier dans la barre latérale « GitHub Pull Request ».

    Capture d'écran de la barre latérale de la « Pull Request GitHub ». Un nom de fichier est mis en évidence avec un encadré orange foncé.

    Cela affiche une vue des différences dans l'éditeur, avec la version du fichier de la branche de base à gauche et la nouvelle version du fichier, à partir de la branche principale de la pull request, à droite.

  4. Pour ajouter un commentaire de révision, cliquez sur le signe + en regard du numéro de ligne dans le fichier affiché à droite de l'éditeur.

    Capture d’écran de la vue de différences. Dans la version principale du fichier, à droite de l'éditeur, le signe Plus en regard d'une ligne est mis en évidence.

  5. Tapez votre commentaire de revue, puis cliquez sur Démarrer la revue.

    Capture d'écran d'un commentaire en cours d'ajout, indiquant « Oui, je suis d'accord, c'est plus clair ». Le bouton « Démarrer la révision » s'affiche sous le commentaire.

  6. Si vous le souhaitez, vous pouvez suggérer une modification que l'auteur de la demande de tirage (pull request) peut cliquer pour valider s'il est d'accord avec votre suggestion. Pour ce faire, cliquez et maintenez le + signe à côté de la première ligne que vous souhaitez suggérer de modifier, puis faites glisser le + signe vers la dernière ligne que vous souhaitez suggérer de modifier. Cliquez ensuite sur Créer une suggestion dans la zone de commentaire qui s'affiche.

    Les lignes que vous avez sélectionnées sont copiées dans la zone de commentaire, où vous pouvez les modifier pour suggérer une modification. Vous pouvez ajouter un commentaire au-dessus de la ligne qui contient ```suggestion pour expliquer votre modification suggérée.

    Cliquez sur Ajouter un commentaire pour ajouter votre suggestion à la demande de tirage (pull request).

    Capture d'écran d'une modification suggérée. Les boutons « Faire une suggestion » et « Ajouter un commentaire » sont affichés sous la modification suggérée.

  7. Une fois que vous avez fini d’ajouter des commentaires de revue, vous pouvez ajouter un commentaire de synthèse pour votre revue de pull request dans la barre latérale « GitHub Pull Request ». Vous pouvez ensuite cliquer sur Commenter et envoyer, ou sur la flèche déroulante et sélectionner Approuver et envoyer ou Demander des modifications et envoyer.

    Capture d'écran de la barre latérale montrant les options de liste déroulante « Commenter et envoyer », « Approuver et envoyer » et « Demander des modifications et envoyer ».

Pour plus d'informations sur l'examen d'un pull request, consultez Révision des changements proposés dans une demande de tirage.

Afficher les commentaires d’une revue dans Codespaces

Une fois que vous avez reçu des commentaires sur une pull request, vous pouvez l’ouvrir dans un codespace dans votre navigateur web, ou dans VS Code, pour consulter les commentaires de revue. À partir de là, vous pouvez répondre aux commentaires, ajouter des réactions ou ignorer la révision.