Les Pull Requests en français
Qu'est-ce qu'une Pull Request ?
Les Pull Requests (PR), ou demandes de tirage en français, sont des demandes visant à intégrer des modifications de code d'une branche à une autre. Elles jouent un rôle fondamental dans le développement de logiciels open-source, permettant aux développeurs de suggérer des changements sur des bases de code souvent vastes et communautaires. Une fois que les modifications ont été examinées, si elles sont acceptées par les auteurs ou les collaborateurs du dépôt, elles sont fusionnées dans la branche principale (indiquée le plus souvent comme "main"). Dans le cas contraire, les mainteneurs peuvent demander des ajustements ou rejeter la PR.
Processus de révision des Pull Requests
Le processus de révision des PR implique généralement :
- Examen du code : Vérification des erreurs potentielles ou des opportunités d'optimisation dans le code soumis.
- Tests : Exécution de tests pour garantir que le code fonctionne comme prévu.
- Discussion : Échanges sur des modifications possibles ou des améliorations.
Comment créer une Pull Request
Méthode 1 : Fork (Idéal pour les projets open-source) 1. Forkez le projet. 2. Clonez le dépôt forké sur votre machine locale. 3. Créez une nouvelle branche et basculez dessus. 4. Apportez les modifications, puis effectuez un commit et push vers votre dépôt forké. 5. Rendez-vous sur la page de votre dépôt forké et cliquez sur l'onglet "Pull requests".
Note : Le fork n’est nécessaire que si vous n'avez pas d'accès en écriture au dépôt d'origine.
Méthode 2 : Collaborateurs (Idéal pour les petites équipes) - Clonez le dépôt sur votre machine. - Créez une nouvelle branche et basculez-dessus. - Apportez vos modifications, commit, puis poussez la branche vers le dépôt. - Allez sur la page du dépôt et cliquez sur l'onglet "Pull Requests".
Méthode 3 : Au sein d'une organisation - Si vous faites partie d'une organisation, selon vos permissions, vous pourriez avoir la possibilité de pousser directement des branches et de créer des PRs. Suivez les étapes de la Méthode 2 pour créer votre PR.
Accéder et configurer vos Pull Requests
Peu importe la méthode utilisée, vous devrez visiter le dépôt concerné pour accéder aux Pull Requests. Dans le dépôt du projet pertinent, naviguez vers l'onglet "Pull requests".
Sur cette page, un bouton bleu "New pull request" vous sera proposé ; il vous suffira de cliquer dessus. Ensuite, configurez votre Pull Request en précisant le dépôt et la branche de destination, ainsi que la branche et le dépôt source.
