Skip to main content

Welcome to a Grasp lesson

Create a free account to keep studying and create your own study path.

Lesson 35

Récupérer les détails et fichiers modifiés d'une pull request

Recommended resources

Bonjour ! Dans la leçon précédente, nous avons configuré un déclencheur GitHub Trigger qui lance notre workflow à chaque nouvelle pull request. Nous avons ainsi établi la connexion entre GitHub et n8n, et nous savons comment capturer les données initiales de l'événement.

Aujourd'hui, nous allons exploiter ces données. L'objectif est de construire un workflow qui récupère la liste complète des fichiers modifiés au sein de cette pull request. En effet, pour qu'un agent IA puisse effectuer une revue de code pertinente, il doit d'abord savoir quels fichiers analyser. Cette étape est donc cruciale pour rassembler les informations nécessaires avant de solliciter l'IA.

1. Du Déclencheur à l'Action : Utiliser les Données Reçues

Rappelez-vous le résultat du test de notre GitHub Trigger de la leçon précédente. Il nous a fourni un objet JSON contenant de nombreuses informations sur la pull request. Parmi elles se trouve une donnée essentielle pour la suite : le numéro de la PR.

Dans n8n, pour accéder aux données d'un nœud précédent, on utilise des expressions. Si vous examinez la structure du JSON, le numéro de la PR se trouve généralement sous pull_request.number. Nous pouvons donc y accéder avec l'expression {{ $json.pull_request.number }}.

Notre première tâche consiste à utiliser ce numéro pour interroger à nouveau l'API de GitHub et demander plus de détails. Pour cela, nous allons ajouter un nouveau nœud à la suite de notre déclencheur : le nœud d'action GitHub.


2. Le Nœud d'Action GitHub

Alors que le trigger se contente d'écouter, le nœud d'action GitHub permet d'agir : créer une issue, commenter une PR, ou, dans notre cas, récupérer des informations.

La documentation de n8n et les guides d'intégration listent les nombreuses opérations prédéfinies disponibles.

GitHub integrations | Workflow automation with n8n

Cette page officielle de n8n liste toutes les actions possibles avec le nœud GitHub.

Parcourez la section Actions prises en charge pour avoir une idée de l'étendue des possibilités. Vous y verrez des actions pour les Issues, les Releases, les Repositories, et bien sûr, les Pull Requests.

Une action qui pourrait sembler pertinente est "Get Pull Requests". Cependant, comme son nom l'indique, elle sert principalement à lister des PRs selon des filtres, pas nécessairement à obtenir les détails spécifiques d'une seule PR, et encore moins la liste des fichiers modifiés.

Intégration GitHub n8n : 31 Actions pour Automatiser Git

Cet article en français présente quelques actions courantes du nœud GitHub.

Lisez la description de l'action Get Pull Requests. Vous remarquerez que ses paramètres sont orientés vers le filtrage d'une liste (état, branche de base, etc.), ce qui confirme qu'elle n'est pas conçue pour récupérer les fichiers d'une PR unique via son numéro.

Alors, comment faire ? C'est un cas de figure très courant en automatisation : parfois, il n'existe pas d'action pré-configurée pour une tâche très spécifique. La solution consiste à utiliser une fonctionnalité plus puissante : l'appel direct à l'API.


3. L'Appel d'API : La Puissance à la Demande

Heureusement, le nœud GitHub de n8n inclut une opération générique nommée "API Call" (Faire un appel à l'API en français). Elle vous permet d'interroger n'importe quel point de terminaison (endpoint) de l'API REST de GitHub, tout en profitant des credentials déjà configurés. C'est la solution parfaite pour notre besoin.

En tant que développeur, vous savez que les APIs REST sont la base de la communication entre services. L'API de GitHub est extrêmement riche et documentée. Pour obtenir la liste des fichiers d'une pull request, l'endpoint est le suivant :
GET /repos/{owner}/{repo}/pulls/{pull_number}/files

Nous allons maintenant construire cette requête dans n8n en utilisant les données dynamiques de notre déclencheur.


4. Construction du Workflow

Reprenez le workflow de la leçon précédente, qui ne contient pour l'instant que le nœud GitHub Trigger.

  1. Cliquez sur le + après le nœud GitHub Trigger et ajoutez un nœud GitHub.
  2. Credentials : Sélectionnez les mêmes identifiants que ceux utilisés pour le trigger.
  3. Resource : Choisissez API Call.
  4. Configurez les champs de l'appel :
    • Request Method : Laissez la valeur par défaut GET.
    • URL : C'est ici que la magie opère. Nous allons reconstruire l'URL de l'endpoint en insérant des expressions pour les parties variables. Entrez la chaîne suivante :
      /repos/{{ $json.repository.owner.login }}/{{ $json.repository.name }}/pulls/{{ $json.pull_request.number }}/files

Détaillons cette URL :

  • /repos/ : C'est le début de l'endpoint.
  • {{ $json.repository.owner.login }} : Cette expression récupère le nom du propriétaire du dépôt à partir des données du trigger. $json fait référence à la sortie du nœud précédent (le trigger).
  • {{ $json.repository.name }} : Récupère le nom du dépôt.
  • {{ $json.pull_request.number }} : Récupère le numéro de la PR qui a déclenché le workflow.
  • /files : Spécifie que nous voulons les fichiers de cette PR.
  1. Testez le nœud : Cliquez sur Test step. Si votre trigger a déjà des données de test issues de la leçon précédente, le nœud GitHub va s'exécuter immédiatement. Sinon, ré-exécutez le test du trigger d'abord.

Le résultat du nœud GitHub devrait être un tableau (Array) d'objets. Chaque objet représente un fichier modifié dans la PR et contient des informations précieuses :

  • filename : Le chemin du fichier.
  • status : L'état du fichier (added, modified, removed).
  • changes : Le nombre de lignes modifiées.
  • patch : Une chaîne de caractères contenant le "diff" du fichier, c'est-à-dire les lignes exactes qui ont été ajoutées ou supprimées. C'est cette information que nous fournirons à l'IA pour son analyse.
Ce schéma illustre un workflow d'analyse de code plus complexe. Les deux premières étapes, "GitLab Trigger" et "Get diff", sont l'équivalent de ce que nous venons de construire pour GitHub : capturer l'événement et récupérer les modifications.

Conclusion

Vous avez franchi une étape fondamentale. Votre workflow ne se contente plus de réagir à un événement ; il est désormais capable d'aller chercher activement des informations complémentaires pour enrichir son contexte.

Les points clés à retenir de cette leçon sont :

  • Le nœud d'action GitHub permet d'interagir avec l'API GitHub.
  • Les expressions (ex: {{ $json.pull_request.number }}) sont essentielles pour utiliser les données d'un nœud dans le suivant.
  • L'opération API Call est un outil extrêmement puissant lorsque aucune action pré-configurée ne correspond à votre besoin. Elle vous donne accès à l'intégralité de l'API d'un service.
  • Nous avons maintenant à notre disposition la liste des fichiers modifiés et, plus important encore, le contenu des diffs (patch), qui sera la matière première de notre analyse par IA.

Nous avons les informations, il est maintenant temps d'agir dessus. Dans la prochaine leçon, nous apprendrons à communiquer en retour avec GitHub. Nous utiliserons ces mêmes principes pour poster un commentaire directement sur la pull request, préparant ainsi le terrain pour y publier la future revue de l'IA.