Visualisation d’un pull request dans GitHub Desktop

Vous pouvez ouvrir une branche de pull request dans GitHub Desktop pour afficher l’historique des validations, exécuter des vérifications ou apporter des modifications.

Dans cet article

À propos des pull requests dans GitHub Desktop

Les pull requests vous permettent de proposer des changements aux projets, de donner des commentaires, d’effectuer des revues et de fusionner les modifications dans les projets. Pour plus d’informations, consultez « À propos des demandes de tirage (pull requests) ».

Lorsque quelqu’un crée un pull request, il apporte des modifications sur une « branche de tête » et suggère ces modifications à une « branche de base », comme main. Dans GitHub Desktop, vous pouvez ouvrir (ou « extraire ») la branche principale d’une requête de tirage pour afficher les modifications suggérées par un contributeur. Par exemple, vous pouvez voir l’historique des validations effectuées par le contributeur, ainsi que les fichiers modifiés, ajoutés ou supprimés par les validations.

La modification de la branche de tête peut être utile si vous souhaitez apporter des modifications à la branche, trop complexes pour être laissées comme suggestions dans une révision. Par exemple, vous pouvez apporter des modifications structurelles à certains contenus, ajouter ou supprimer des fichiers ou résoudre un conflit de fusion trop complexe à résoudre sur GitHub. À partir de GitHub Desktop, vous pouvez afficher la branche dans l’éditeur de texte de votre choix pour voir les modifications ou apporter d’autres mises à jour.

Vous pouvez également simplement afficher des informations telles que l'historique des commits et les vérifications de statut dans un environnement familier, sans avoir à accéder à la pull request sur GitHub. Si des vérifications ont été activées dans votre dépôt, GitHub Desktop indique l'état des vérifications dans la requête de tirage et vous permet de les réexécuter. Pour plus d'informations, consultez Travailler avec une requête de tirage dans GitHub Desktop.

Vous ne pouvez pas commenter une pull request depuis GitHub Desktop. Après avoir examiné les changements apportés dans une pull request, vous pouvez faire part de vos commentaires sur GitHub. Pour plus d’informations, consultez À propos des révisions de demande de tirage et la consultation d'une pull request sur GitHub.

Ouverture d’une branche de pull request dans GitHub Desktop

  1. Dans GitHub Desktop, cliquez sur Canal actuel.

    Capture d’écran de la barre du dépôt. Un bouton, intitulé « Current Branch » avec une flèche vers le bas indiquant un menu déroulant, est encadré en orange.

  2. En haut du menu déroulant, cliquez sur Requête de tirage.

    Capture d’écran du menu déroulant « Branche actuelle ». Un onglet intitulé « Demandes de tirage » est mis en évidence avec un encadré orange.

  3. Dans la liste des demandes de tirage, cliquez sur la demande de tirage que vous souhaitez afficher.

    Pour actualiser la liste des pull requests, cliquez sur .

    Capture d’écran de l’onglet « Demandes de tirage ». Un bouton, étiqueté avec une icône de deux flèches formant un cercle, est mis en surbrillance avec un contour orange.

Lorsque vous avez ouvert une branche de demande de tirage, vous pouvez afficher le contenu de la branche dans un éditeur, afficher les l’historique des différences et validations des mises à jour du contributeur, puis afficher et réexécuter les vérifications. Pour plus d’informations, consultez Utilisation d’une demande de tirage dans GitHub Desktop.

Ouverture d'une branche de pull request dans GitHub Desktop depuis GitHub

  1. Sous le nom de votre référentiel, cliquez sur Demandes de tirage.

    Capture d’écran de la page principale d’un dépôt. Dans la barre de navigation horizontale, un onglet intitulé « Demandes de tirage » est indiqué en orange foncé.

  2. Dans la liste des pull requests, cliquez sur celle que vous souhaitez ouvrir avec GitHub Desktop.

  3. À droite du titre de la demande de retrait, cliquez sur Code, puis, dans l'onglet Local, cliquez sur Validation avec GitHub Desktop.

    Capture d’écran d’une pull request sur GitHub. Le menu déroulant « Code » est développé et le bouton « Checkout with GitHub Desktop » est souligné en orange.

Lorsque vous avez ouvert une branche de demande de tirage, vous pouvez afficher le contenu de la branche dans un éditeur, afficher les l’historique des différences et validations des mises à jour du contributeur, puis afficher et réexécuter les vérifications. Pour plus d’informations, consultez Utilisation d’une demande de tirage dans GitHub Desktop.

Utilisation d’une pull request dans GitHub Desktop

Une fois que vous avez vérifié la branche d'une pull request, vous pouvez utiliser GitHub Desktop et votre éditeur local pour afficher les modifications du contributeur ou apporter d'autres modifications à la branche. Par exemple, vous pouvez :

  •         [Ouvrir la branche dans votre éditeur](#open-the-branch-in-your-editor)

  •         [Afficher l'historique des validations](#view-the-commit-history)

  •         [Afficher et réexécuter les vérifications](#view-and-re-run-checks)

Ouvrir la branche dans votre éditeur

Si vous souhaitez examiner les modifications dans leur contexte ou apporter des mises à jour supplémentaires à une pull request, vous pouvez consulter le contenu de la branche dans votre éditeur local.

  1. Dans la barre de menus « GitHub Desktop », sélectionnez Référentiel.

  2. Cliquez sur Ouvrir dans l’ÉDITEUR.

    Capture d’écran d’une barre de menus sur un Mac. Sous le menu déroulant « Référentiel », un curseur pointe sur « Ouvrir dans Visual Studio Code », mis en surbrillance en bleu.

Pour plus d’informations, consultez « Configuration d’un éditeur par défaut dans GitHub Desktop ».

Afficher l'historique des validations

Vous pouvez afficher l’historique des validations de la branche si vous souhaitez voir comment le contributeur est arrivé à l’ensemble des modifications suggérées.

  1. Dans la barre latérale gauche, cliquez sur Histoire.

    Capture d’écran de l’onglet « Historique » dans la barre latérale. Au-dessus d’une liste de validations, le bouton d’onglet, intitulé « Historique » est mis en évidence avec un contour orange.

  2. Dans « Sélectionner la branche à comparer... », recherchez et sélectionnez la branche principale de la pull request.

  3. Cliquez sur l’onglet Avenir.

    Capture d’écran de l’onglet « Historique ». Au-dessus d’une liste de validations, « main » est entré en tant que branche à comparer, avec un onglet intitulé « En avance » souligné en orange.

Pour plus d’informations, consultez « Affichage de l’historique des branches dans GitHub Desktop ».

Afficher et réexécuter les vérifications

Vous pouvez voir le statut des vérifications exécutées sur la branche de pull request. Les vérifications ayant échoué peuvent indiquer des problèmes avec les modifications proposées, ce qui peut empêcher la fusion de la branche. Vous pouvez réexécuter des vérifications à partir de GitHub Desktop. Pour plus d’informations, consultez « Affichage et réexécution des vérifications dans GitHub Desktop ».

Affichage d'une pull request dans GitHub

Pour ajouter des commentaires à une demande de tirage, laisser un avis ou fusionner la demande de tirage, vous devez accéder à la demande de tirage sur GitHub. Une fois que vous avez vérifié une branche de pull request dans GitHub Desktop, vous pouvez ouvrir rapidement le pull request correspondant sur GitHub.

  1. Dans la barre de menus GitHub Desktop, cliquez sur Branche.

  2. Sélectionnez Voir une pull request sur GitHub .

    Capture d’écran de la barre de menus sur un Mac. Le menu déroulant « Branche » est développé et le curseur pointe sur « Afficher la pull request sur GitHub ».