Au chapitre précédent, on a parlé des stratégies de branches. Ici, on entre dans le concret, côté développeur, en s’appuyant sur Git Flow.

Le problème

J’ai créé ma branche à partir de develop, j’ai terminé mon développement et je l’ai poussée. Et maintenant ?

La logique serait de merger ma branche dans develop. Mais s’il n’y a aucune vérification du code avant, il manque deux étapes :

  1. Prévenir l’équipe que ma tâche est terminée et qu’elle a besoin d’une revue de code avant d’être mergée.
  2. Le responsable doit vérifier les commits avant de les intégrer.

Pour faire ces deux étapes simplement, on utilise les pull requests.

C’est quoi une pull request ?

Une pull request (PR) est une demande d’intégration : elle permet à un développeur de prévenir son équipe qu’il a terminé une fonctionnalité, et de proposer ses modifications pour qu’elles soient relues avant d’être mergées.

C’est quoi un fork ?

Pour mieux protéger le projet, on ajoute les forks. Un fork est une copie du projet dans ton propre compte. Tu peux y faire toutes les modifications que tu veux sans toucher au projet original. Pour proposer tes changements, tu ouvres une pull request : le responsable fait la revue de code, puis accepte ou refuse.

Exemple sur GitHub

1. Forker le projet

Sur la page du projet, clique sur Fork. GitHub crée la copie dans ton compte : ton-compte/le-projet, avec la mention forked from le projet original.

2. Cloner le fork

En ligne de commande avec git clone, ou avec GitHub Desktop, plus simple si tu débutes.

3. Créer une branche et faire ses modifications

git branch
# * master

git checkout -b feature/1

# … modifications …

git status
git commit -am "Modification 1"
git push -u origin feature/1

Avec GitHub Desktop, le bouton Publish branch fait la même chose que le dernier git push.

4. Ouvrir la pull request

Sur GitHub, va dans l’onglet Pull requests, puis New pull request. GitHub affiche deux côtés :

  • base : le projet original et la branche dans laquelle tu veux intégrer tes changements (ici master) ;
  • compare : ton fork et ta branche (ici feature/1).

GitHub te montre une dernière fois tous tes changements. Tu as oublié quelque chose ? Fais un nouveau commit et pousse-le : il s’ajoute automatiquement à la même pull request.

Clique sur Create pull request.

5. La revue de code

Sur le projet original, la pull request apparaît. Le responsable :

  • vérifie les commits ;
  • relit les modifications dans l’onglet Files changed : c’est la revue de code ;
  • puis accepte (merge) ou refuse.

Les options de merge

OptionCe qu’elle fait
Create a merge commitGarde tous les commits et ajoute un commit de merge
Squash and mergeFusionne tous les commits de la PR en un seul, idéal s’il y en a plusieurs
Rebase and mergeRejoue les commits un par un sur la branche cible, sans commit de merge

Une fois la PR mergée, tes modifications sont sur la branche master du projet original.

Exercice · Quelle option de merge ?

Ta PR contient 6 commits : « wip », « fix typo », « encore un fix », « ajoute le formulaire »… Quelle option de merge choisir pour garder un historique propre sur main ?

Voir la solution

Squash and merge. Les 6 commits deviennent un seul commit sur main, avec un message clair comme « Ajoute le formulaire de contact ». Les étapes intermédiaires n’encombrent pas l’historique du projet.

La suite

Ton fork est une copie : comment récupérer les nouvelles modifications du projet original ? Réponse au prochain chapitre, avec le remote upstream.


Ceci est le chapitre 8 du cours Git en pratique. Suis la série pour apprendre à utiliser Git au quotidien et en équipe.