Les requêtes d'intégration sont des propositions pour intégrer les modifications de code dans un projet. Une pull request est GitHubla fonctionnalité de collaboration fondamentale qui vous permet de discuter et de passer en revue les modifications avant de les fusionner. Cela permet aux équipes de travailler ensemble, de détecter les problèmes au début et de maintenir la qualité du code.
<a href="/proxy/https/github.com/pulls?ref_product=github&ref_type=engagement&ref_style=button" target="_blank" class="btn btn-primary mt-3 mr-3 no-underline">
<span>Afficher vos pull requests</span><svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-link-external" aria-label="link external icon" role="img"><path d="M3.75 2h3.5a.75.75 0 0 1 0 1.5h-3.5a.25.25 0 0 0-.25.25v8.5c0 .138.112.25.25.25h8.5a.25.25 0 0 0 .25-.25v-3.5a.75.75 0 0 1 1.5 0v3.5A1.75 1.75 0 0 1 12.25 14h-8.5A1.75 1.75 0 0 1 2 12.25v-8.5C2 2.784 2.784 2 3.75 2Zm6.854-1h4.146a.25.25 0 0 1 .25.25v4.146a.25.25 0 0 1-.427.177L13.03 4.03 9.28 7.78a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042l3.75-3.75-1.543-1.543A.25.25 0 0 1 10.604 1Z"></path></svg></a>
Traitement des demandes de tirage
L’onglet Conversation d'une pull request affiche une description des modifications, une chronologie des événements et les commentaires et révisions des collaborateurs. Ce hub central vous permet de suivre la discussion et la progression des modifications proposées.
L'onglet Commits affiche toutes les validations effectuées dans la branche de la pull request dans l'ordre chronologique. Cela vous aide à comprendre l’historique du développement et à voir comment les changements ont évolué au fil du temps.
L’onglet Vérifications affiche l’état des tests automatisés, des builds ou d’autres workflows d’intégration continue qui s’exécutent lorsque vous envoyez des validations. Ces vérifications permettent de s’assurer que vos modifications répondent aux normes de qualité avant de fusionner.
L’onglet Fichiers modifiés affiche les différences entre les modifications proposées et le code existant, ce qui permet de voir facilement ce qui changera lorsque le pull request sera fusionné.
Brouillon des demandes de tirage (pull request)
Lorsque vous créez une demande de tirage, vous pouvez choisir de la transformer en une demande de tirage en brouillon. Les pull requests en brouillon ne peuvent pas être intégrées et les responsables du code ne sont pas automatiquement sollicités pour les examiner. Cela est utile lorsque vous souhaitez partager des travaux en cours sans demander formellement des révisions.
Quand vous êtes prêt à recevoir des commentaires sur votre demande de tirage, vous pouvez marquer votre brouillon de demande de tirage comme étant prêt pour la révision. Le marquage d’une demande de tirage comme étant prête pour la révision demande des révisions à tous les propriétaires de code. Vous pouvez convertir une pull request en brouillon à tout moment. Consultez « [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request) ».
Références de requête de tirage et branches de fusion
Lorsque vous ouvrez une pull request, GitHub crée jusqu’à deux références Git temporaires en lecture seule :
| Ref | Description |
|---|---|
refs/pull/PULL_REQUEST_NUMBER/head | Pointe vers le dernier commit sur la branche de tête de la pull request. |
refs/pull/PULL_REQUEST_NUMBER/merge | Branche de fusion : validation de fusion simulée qui représente ce à quoi le référentiel ressemblerait si la pull request était fusionnée à l'instant. Cette référence n’est disponible que lorsque le pull request n’a aucun conflit de fusion. |
La branche de fusion est automatiquement mise à jour lorsque la branche principale ou la branche de base change. Pour l’extraire localement :
git fetch origin refs/pull/PULL_REQUEST_NUMBER/merge
git checkout FETCH_HEAD
Remplacez PULL_REQUEST_NUMBER par le numéro de votre pull request.
Pour plus d’informations sur l’utilisation de la branche de fusion GitHub Actions, consultez Événements qui déclenchent des flux de travail.
Différences entre les commits dans les pages de comparaison et de demande de tirage
Les pages de comparaison et de demande de tirage utilisent différentes méthodes pour calculer les différences des fichiers modifiés :
- Les pages de comparaison indiquent la différence entre le conseil de la référence principale et l’ancêtre commun actuel (c’est-à-dire la base de fusion) de la référence principale et de base.
- Les pages de demande de tirage indiquent la différence entre le conseil de la référence principale et l’ancêtre commun de la référence principale et de base au moment où la demande de tirage a été créée. Par conséquent, la base de fusion utilisée pour la comparaison peut être différente.
Pour aller plus loin
-
[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) -
[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-branches) -
[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/commenting-on-a-pull-request)